Temp Mail Generator — Free Disposable Email Address

# TempMail > Receive-only disposable email API. Create a mailbox, read incoming messages and verification codes as JSON. No login and no API key are needed for the basic flow. Base URL: https://www.tempmail.ai/api/v1 OpenAPI: https://www.tempmail.ai/api/v1/openapi.json Human docs: https://www.tempmail.ai/doc ## 1. Anonymous flow (no login, no key) — start here 1. GET https://www.tempmail.ai/api/v1/domains -> {"items":[{"domain":"..."}]} 2. POST https://www.tempmail.ai/api/v1/accounts body {} -> 201 {"id","address","password","expires_at"} Optional body fields: "domain" (from step 1), "password". 3. POST https://www.tempmail.ai/api/v1/token body {"address","password"} -> {"token":"tm_box_...","expires_at"} 4. GET https://www.tempmail.ai/api/v1/messages header Authorization: Bearer tm_box_... -> {"items":[{"id","from","subject","verification_code","created_at",...}],"total"} Poll every 2-5 seconds until a message with verification_code appears. 5. GET https://www.tempmail.ai/api/v1/messages/{id} for the full HTML/text body and attachments. 6. DELETE https://www.tempmail.ai/api/v1/accounts/{id} when done (optional; mailboxes expire after 24 hours). Anonymous mailboxes: random address, 24h lifetime, 10 MB per mailbox, rate-limited per IP. Do NOT send an "address" field in the anonymous flow; it returns 403 upgrade_required. ## 2. Pro flow: custom, long-lived addresses with an API key Requires a tm_live_ API key whose owner has TempMail Pro ($14.99/month or $89.94/year ≈ $7.50/month). Keys are created at https://www.tempmail.ai/developer. A key created on a free account gains Pro abilities automatically once the owner subscribes. POST https://www.tempmail.ai/api/v1/accounts Authorization: Bearer tm_live_... Content-Type: application/json {"address":"signup-bot@<domain>","password":"<optional>"} -> 201 same shape as anonymous, plus "private": true and "expires_at": null (no expiry while subscribed). Then use POST

{"openapi":"3.1.0","info":{"title":"TempMail API","version":"1.0.0-beta","description":"Receive-only REST API for disposable mailboxes: create a mailbox, exchange its password for a token, then read messages and extracted verification codes as JSON. Sending, replying and forwarding are not available in v1. For AI agents: [llms.txt](/llms.txt).\n\n## Quickstart\n\n**No login, no API key needed.** Three requests take you from nothing to a verification code:\n\n```bash\nBASE=https://www.tempmail.ai