Lumeo APIs
Email

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 playground

Temp 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)

EndpointWhat it returns
GET/mailbox/createCreate 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/messagesList messages
Newest first - sender, subject, received time, preview, extracted OTP code, attachment count. Use since= (ISO time) to get only new ones.
GET/mailbox/waitWait 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/messageRead a message
Full message - text, HTML, all links, OTP code, attachments (name, type, size) and key headers.
GET/message/deleteDelete a message
GET/mailbox/extendExtend a mailbox
Adds minutes (10-1440) to the mailbox lifetime (up to 7 days total).
GET/mailbox/deleteDelete a mailbox
Deletes the mailbox and all its messages immediately.
GET/domainsAvailable 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'

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

Related APIs

Email

Email Validation API

Validate emails in real time: syntax, MX/DNS, disposable detection (10k+ domains), role & free accounts, typo fix, SPF/DMARC, score. Bulk too.