Simple and powerful REST API to generate temporary email addresses and receive emails programmatically.
Generates a new random temporary email address. Each call returns a unique email address that can be used to receive emails.
No parameters required.
{
"success": true,
"email": "abc123xy@gettrustiva.com"
}
Fetches all emails received at the specified temporary email address. Returns a list of messages with basic information like sender, subject, date, and a preview snippet.
| Parameter | Type | Description |
|---|---|---|
| email required | string | The temporary email address to check inbox for |
{
"success": true,
"email": "abc123xy@gettrustiva.com",
"count": 2,
"messages": [
{
"uid": 12345,
"from": "sender@example.com",
"subject": "Welcome to our service",
"date": "2025-01-15 10:30:00",
"snippet": "Thank you for signing up..."
}
]
}
Retrieves the full content of a specific email message by its UID. For security, you must provide the email address to verify ownership of the message.
| Parameter | Type | Description |
|---|---|---|
| uid required | integer | Unique identifier of the message (from inbox response) |
| email required | string | Email address for security validation |
{
"success": true,
"message": {
"uid": 12345,
"from": "sender@example.com",
"subject": "Welcome to our service",
"date": "2025-01-15 10:30:00",
"body": "<html>...email content...</html>"
}
}
| Code | Status | Description |
|---|---|---|
| 200 | OK | Request successful |
| 400 | Bad Request | Missing or invalid parameters |
| 403 | Forbidden | Access denied - message doesn't belong to the email |
| 404 | Not Found | Message not found |
| 500 | Server Error | Internal server error |
// Step 1: Generate a temporary email fetch('/api_generate.php') .then(res => res.json()) .then(data => { const email = data.email; console.log('Generated:', email); // Step 2: Check inbox (poll every 3 seconds) setInterval(() => { fetch(`/api_inbox.php?email=${email}`) .then(res => res.json()) .then(inbox => { console.log('Messages:', inbox.count); // Step 3: Read a message if (inbox.messages.length > 0) { const uid = inbox.messages[0].uid; fetch(`/api_message.php?uid=${uid}&email=${email}`) .then(res => res.json()) .then(msg => console.log(msg.message.body)); } }); }, 3000); });