API Documentation

Authentication

All API requests require an API key. Include it in the header:

Authorization: Bearer YOUR_API_KEY

Get your API key from your Premium dashboard.

API Endpoints

Generate Email

POST

/api/v1/email/generate

Creates a new temporary email address

Response:

{
    "success": true,
    "email": "abc123@temp-mail.test",
    "expires_at": "2024-01-01T12:00:00Z"
}
                            

Get Messages

GET

/api/v1/email/{email}/messages

Retrieves all messages for an email address

Response:

{
    "success": true,
    "messages": [
        {
            "id": 1,
            "from": "sender@example.com",
            "subject": "Welcome!",
            "preview": "Thanks for signing up...",
            "received_at": "2024-01-01T12:00:00Z"
        }
    ]
}
                            

Code Examples

JavaScript (Fetch)

const response = await fetch('https://temp-mail.test/api/v1/email/generate', {
    method: 'POST',
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    }
});

const data = await response.json();
console.log(data.email);
                        

Python (Requests)

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.post(
    'https://temp-mail.test/api/v1/email/generate',
    headers=headers
)

data = response.json()
print(data['email'])
                        

Rate Limits

Plan	Requests/Day	Requests/Minute
Free	-	-
Pro	1,000	60
Enterprise	Unlimited	1,000