REST API

JSON over HTTPS. Bearer JWT for authenticated calls.

POST /api/v1/auth/token

Exchange email/password for a JWT.

curl -X POST mail.fbmail.icu/api/v1/auth/token \
  -d 'email=you@x.com' -d 'password=...'

POST /api/v1/inbox

Create a new temporary inbox.

curl -X POST mail.fbmail.icu/api/v1/inbox -H 'Authorization: Bearer <jwt>'

GET /api/v1/inbox/{id}

List messages for an inbox.

curl mail.fbmail.icu/api/v1/inbox/123?page=1

GET /api/v1/message/{id}

Fetch a single message.

curl mail.fbmail.icu/api/v1/message/456

GET /api/v1/domains

List active domains.

curl mail.fbmail.icu/api/v1/domains