Temp Mail API
Disposable temp email inboxes via API: create address, receive real email, auto-extracted OTP codes & links, long-poll wait, private tokens.
Get a free API key on RapidAPI Try it in the playgroundTemp Mail API
Disposable email inboxes on demand. Create an address, receive real email, and read it over the API.
📮 Mailbox
Random or custom addresses, a lifetime of 10 minutes to 24 hours (extendable), and instant delete.
📥 Messages
Sender, subject, text and HTML, every link, attachments (name, type, size) and automatically extracted verification codes (OTP). A long-poll endpoint returns the moment a message arrives, which is ideal for sign-up and password-reset tests.
🔒 Private by design
Every mailbox has its own secret token, mail to unknown addresses is rejected, and everything auto-deletes on expiry.
Use cases: QA and end-to-end tests · automation and bots · OTP capture · privacy-friendly sign-ups
Keywords: temp mail api, temporary email api, disposable email api, 10 minute mail api, fake email api, receive email api, otp email api, burner email
Endpoints (8)
| Endpoint | What it returns |
|---|---|
GET/mailbox/create | Create a mailbox Creates a new temporary address (random, or your chosen name) and returns it with its private token. The mailbox lives ttl_minutes (10-1440, default 60) and can be extended. |
GET/mailbox/messages | List messages Newest first - sender, subject, received time, preview, extracted OTP code, attachment count. Use since= (ISO time) to get only new ones. |
GET/mailbox/wait | Wait for a new message Long-poll - returns as soon as a message arrives (or after timeout seconds, max 28). Perfect for sign-up flows waiting for a verification code. |
GET/message | Read a message Full message - text, HTML, all links, OTP code, attachments (name, type, size) and key headers. |
GET/message/delete | Delete a message |
GET/mailbox/extend | Extend a mailbox Adds minutes (10-1440) to the mailbox lifetime (up to 7 days total). |
GET/mailbox/delete | Delete a mailbox Deletes the mailbox and all its messages immediately. |
GET/domains | Available domains |
Quick start
Subscribe on RapidAPI (free plan available), copy your key, and call GET /mailbox/create:
curl --request GET \
--url 'https://temp-mail-api14.p.rapidapi.com/mailbox/create?ttl_minutes=60' \
--header 'x-rapidapi-host: temp-mail-api14.p.rapidapi.com' \
--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'import requests
url = "https://temp-mail-api14.p.rapidapi.com/mailbox/create?ttl_minutes=60"
headers = {
"x-rapidapi-host": "temp-mail-api14.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY",
}
resp = requests.get(url, headers=headers)
print(resp.json())const res = await fetch("https://temp-mail-api14.p.rapidapi.com/mailbox/create?ttl_minutes=60", {
method: "GET",
headers: {
"x-rapidapi-host": "temp-mail-api14.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
});
console.log(await res.json());
Start free. Every plan includes all endpoints; upgrade only when you need more requests. Runs on Cloudflare's global network for low latency worldwide.
Subscribe on RapidAPI