API Documentation
A robust, RESTful API for developers to programmatically generate and manage disposable email addresses.
1. Generate New Email
Creates a new, unique temporary email address. No authentication required. Expires in 60 minutes.
POST
https://disposemail.xyz/api/v1/addressesJSON Response
{
"address": "[email protected]",
"expires_at": "2026-03-06T15:58:00Z"
}2. Fetch Messages
Retrieves the inbox contents for a specific active email address. Requires the address identifier.
GET
https://disposemail.xyz/api/v1/addresses/:address/messagesJSON Response
{
"messages": [
{
"id": "msg_98abc123",
"from": "[email protected]",
"subject": "Your verification code",
"body": "Your code is 491029.",
"received_at": "2026-03-06T14:59:12Z"
}
]
}Rate Limiting
To ensure stability, our public API is heavily rate-limited to 10 requests per minute per IP address. For enterprise access without strict limits, please contact support.