destroy.network API
Build integrations with disposable email inboxes. Create temporary addresses, receive messages in real-time, and manage custom domains programmatically.
https://destroy.network/apiQuick Start
Get started in seconds. No authentication required for basic operations.
Create an Inbox
Generate a temporary email address with a single API call.
curl -X POST \
https://destroy.network/api/inboxCheck for Messages
Poll the inbox to retrieve any received emails.
curl https://destroy.network/api/\
inbox/{id}/messagesStream Real-Time
Subscribe to live updates via Server-Sent Events. New messages are pushed instantly.
curl -N https://destroy.network/api/inbox/{id}/streamAuthentication
Choose the authentication method that fits your needs.
No Auth Required
Create inboxes, read messages, stream updates
API Key
Higher rate limits, custom domains, attachments
Pro/Business
Unlimited inboxes, webhooks, priority support
Using API Keys
Include your API key in the Authorization header:
curl https://destroy.network/api/inbox \
-H "Authorization: Bearer sk_live_your_api_key_here"Rate Limits
| Plan | Inboxes/Hour | Max Active | Extensions |
|---|---|---|---|
| Anonymous | 2 | 1 | 1 |
| Free (signed in) | 5 | 3 | 1 |
| Pro | 25 | 10 | Unlimited |
| Business | Unlimited | 50 | Unlimited |
Anonymous limits apply per IP address. Sign in for a free account to unlock the higher Free tier instantly.
Error Handling
The API uses standard HTTP status codes. Errors return JSON with a message field.
{
"message": "Inbox not found"
}| Status | Description |
|---|---|
| 200 | Success |
| 201 | Created |
| 400 | Bad Request - Invalid parameters |
| 401 | Unauthorized - Authentication required |
| 403 | Forbidden - Permission denied or limit exceeded |
| 404 | Not Found - Resource doesn't exist |
| 410 | Gone - Inbox has expired |
| 429 | Too Many Requests - Rate limit exceeded |