Fake Email API

Programmatic disposable mailboxes. All endpoints return JSON, no auth required. Base URL: https://fake-email.site.

Discovery

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