Fake Email API
Programmatic disposable mailboxes. All endpoints return JSON, no auth required. Base URL: https://fake-email.site.
Discovery
- OpenAPI 3.1 spec: /openapi.json
- API catalog (RFC 9727): /.well-known/api-catalog
- Agent skills: /.well-known/agent-skills/index.json
- Health probe: /api/health
POST /api/temporary-address
Create a temporary mailbox. Body is optional; omit usernamefor a random one.
curl -X POST https://fake-email.site/api/temporary-address \
-H "Content-Type: application/json" \
-d '{"username":"alice"}'
# => {"temp_email_addr":"alice@fake-email.site"}GET /api/inbox/poll
Poll messages delivered to a temporary mailbox.
curl "https://fake-email.site/api/inbox/poll?address=alice@fake-email.site"GET /api/health
Liveness probe for monitoring.
curl https://fake-email.site/api/health