Disposable Email Inbox
Create disposable temporary inboxes in seconds, read incoming emails, and fetch attachment download links. Disposable Inbox API is a developer-first temporary email API built for privacy-safe signups and verification workflows. Use it to generate inboxes on demand, receive verification emails, inspect full message content, and manage inbox lifecycle with predictable REST endpoints. Temp Email API.
Disposable Email Inbox endpoints
| Method | Endpoint | Description |
|---|---|---|
| Status | ||
| GET |
getServiceStatus /status |
Safe health endpoint for uptime checks. Returns no internal diagnostics. |
| Domains | ||
| GET |
listAvailableDomains /domains |
Returns domains available for inbox creation. BASIC users see free domains; PRO/ULTRA users also see premium domains marked with `is_premium`. |
| Inboxes | ||
| GET |
listInboxes /inboxes |
Returns a paginated list of your inboxes. Optionally filter by name. |
| POST |
createRandomInbox /random |
Creates an inbox with an auto-generated username and auto-selected domain — no request body needed. BASIC users get free domains; PRO/ULTRA get premium domains. Lifespan uses… |
| POST |
createInbox /inboxes |
Creates a new disposable inbox. Optionally specify `name`, `domain`, and `lifespan` (in seconds) — or omit all fields to get defaults. BASIC plans support presets: 600, 900,… |
| PATCH |
extendInboxLifespan /inboxes/extend |
Extends an inbox's expiration from the current time. PRO/ULTRA only — BASIC users receive a 403. Identify the inbox by `inboxId` (UUID) or `inbox` (email address). Pass… |
| DELETE |
deleteInbox /inboxes |
Permanently deletes an inbox and all its messages. Identify the inbox by `inboxId` (UUID) or `inbox` (email address). |
| Messages | ||
| GET |
listMessages /messages |
Returns paginated messages for a single inbox. Identify the inbox by `inboxId` (UUID) or `inbox` (email address). Optionally filter by `from`, `subject`, or `hasAttachments`. |
| GET |
getMessageById /messages/{emailId} |
Returns full message content (text, HTML, attachments) and marks it as read. Identify the inbox by `inboxId` (UUID) or `inbox` (email). Use `fresh=true` to bypass cache. |
| DELETE |
deleteMessage /messages/{emailId} |
Permanently deletes a message. Identify the inbox by `inboxId` (UUID) or `inbox` (email address). |
| Attachments | ||
| GET |
getAttachmentQuota /attachments/users/quota |
Returns your current attachment storage usage and quota limits. PRO/ULTRA only. |
| GET |
listAttachments /attachments |
Returns a paginated list of your attachments. PRO/ULTRA only. |
| GET |
getAttachmentDownloadUrl /attachments/{attachmentId}/download |
Generates a time-limited signed download URL for an attachment. PRO/ULTRA only. |
| DELETE |
deleteAttachment /attachments/{attachmentId} |
Permanently deletes an attachment and frees up quota. PRO/ULTRA only. |
Disposable Email Inbox pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 60 / minute |
|
| PRO | $4.99 / month | 360 / minute |
|
| ULTRA Recommended | $8.99 / month | 900 / minute |
|