Developer API

TempMailbox API

A small REST + SSE surface for creating disposable inboxes and reading mail. No keys required for the local dev server. Production deployments enforce per-IP rate limits.

Base URL

http://localhost:3001

Endpoints

POST/api/inbox

Create a new disposable inbox. Returns address + expiry.

body: { "local"?: string, "domain"?: string }

→ { "address": "...", "createdAt": 1234, "expiresAt": 1234 }

GET/api/inbox/:address

List the messages currently in an inbox.

→ { "address": "...", "expiresAt": 1234, "messages": [...] }

GET/api/inbox/:address/message/:id

Fetch a single message including its body and attachments.

DELETE/api/inbox/:address/message/:id

Delete a message from the inbox before expiry.

GET/api/inbox/:address/stream

Server-Sent Events stream of new messages, in real time.

GET/api/domains

List the domains accepted by the SMTP receiver.

Quickstart

curl -s -X POST http://localhost:3001/api/inbox \
  -H 'Content-Type: application/json' \
  -d '{}'

# → { "address": "quick.lynx.ab12cd@tempmail.local", ... }

Rate limits

Free tier: 60 inbox creations per hour per IP. Pro: 600/hour. Business: configurable. Exceeded requests return 429 Too Many Requests.