TempBox
HomeBlog

Developer API

Create disposable inboxes and read their mail programmatically — ideal for automated sign-up testing and QA.

All endpoints are under https://temporaryemail.world/api/v1 and require an API key in the Authorization header. Need a key? Contact us — paid plans with higher limits are available.

Authentication

Authorization: Bearer YOUR_API_KEY

Each key has a daily request limit; exceeding it returns 429.

Create an inbox

curl -X POST https://temporaryemail.world/api/v1/inboxes \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ttl_minutes": 10}'

→ { "id": "…", "address": "swiftotter8841ab@temporaryemail.world", "expires_at": 1792000000000, "ttl_minutes": 10 }

List messages

curl https://temporaryemail.world/api/v1/inboxes/{address}/messages \
  -H "Authorization: Bearer YOUR_API_KEY"

→ { "address": "…", "messages": [ { "id": "…", "from_addr": "…", "subject": "…", "received_at": 1792000000000, "has_text": 1, "has_html": 1 } ] }

Read a message

curl https://temporaryemail.world/api/v1/messages/{id} \
  -H "Authorization: Bearer YOUR_API_KEY"

→ { "id": "…", "from_addr": "…", "subject": "…", "text_body": "…", "html_body": "…", "received_at": … }

Release an inbox

curl -X DELETE https://temporaryemail.world/api/v1/inboxes/{address} \
  -H "Authorization: Bearer YOUR_API_KEY"

Notes