XminMail
# Every other temp-mail API makes you poll Create an address, then sit in a loop asking *"anything yet?"* every two seconds — paying for each empty answer — until the code finally shows up. **XminMail just tells you.** Register an HTTPS endpoint and the message arrives at your server the moment it lands. Signed, retried automatically, and it never touches your request quota. > Measured on a…
XminMail endpoints
| Method | Endpoint | Description |
|---|---|---|
| Inbox | ||
| DELETE |
deleteInbox /v1/inbox/{id} |
Immediately removes the inbox, its messages, its attachments and its stored sources. Irreversible, and the address stops accepting mail at once. |
| POST |
extendInbox /v1/inbox/{id}/extend |
Adds one hour, up to a total lifetime of 24 hours from creation. `extended_by` reports the time actually gained, which is 0 once the ceiling is reached. |
| GET |
getInbox /v1/inbox/{id} |
Returns when the inbox expires, how much it holds and whether a webhook is registered. Use it to decide whether to extend before the inbox disappears. |
| POST |
createInbox /v1/inbox |
Creates a disposable inbox and returns its address plus the bearer token used for every later call on it. The token is shown once and cannot be recovered. Everything the inbox… |
| Messages | ||
| GET |
getMessage /v1/inbox/{id}/messages/{messageId} |
Returns the headers, the plain-text body, the HTML body and the attachment list. `html_body` is sender-controlled: sandbox or sanitize it before rendering. |
| GET |
getMessageSource /v1/inbox/{id}/messages/{messageId}/source |
Returns the message exactly as it arrived, headers and MIME parts intact, as `message/rfc822`. Use it to inspect SPF, DKIM and DMARC results, to debug a sender, or to hand the… |
| DELETE |
deleteMessage /v1/inbox/{id}/messages/{messageId} |
Removes the message, its attachments and its stored source, and frees the quota they held so the inbox can receive more. |
| GET |
listMessages /v1/inbox/{id}/messages |
Newest first by arrival time, so a forged Date header cannot push a message to the top. Returns summaries only - fetch a message by id for its body. |
| Attachments | ||
| GET |
downloadAttachment /v1/inbox/{id}/attachments/{attachmentId} |
Streams the attachment bytes with its original filename and content type. Supports HTTP Range requests for resumable downloads. |
| GET |
listMessageAttachments /v1/inbox/{id}/messages/{messageId}/attachments |
Returns attachment metadata without the message bodies - useful when you only need to know what is attached before deciding whether to download it. |
| Webhooks | ||
| PUT |
setWebhook /v1/inbox/{id}/webhook |
Registers an HTTPS endpoint that receives a POST for every message this inbox gets - the alternative to the WebSocket stream for clients that cannot hold a socket open.… |
| Service | ||
| GET |
listDomains /v1/domains |
Returns every domain this service accepts mail for. Pass one of these as `domain` when creating an inbox; omit it to get the default. Call this instead of hardcoding a domain, so… |
| GET |
getHealth /health |
Returns 200 while the service can serve requests, and 503 when it is running but misconfigured. Requires no credentials and touches no inbox data. Safe to poll from an uptime… |
XminMail pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 5 / second |
|
| PRO | $9 / month | 20 / second |
|
| ULTRA Recommended | $29 / month | 50 / second |
|
| MEGA | $99 / month | 100 / second |
|