API Documentation
Complete guide to using Temporary Email Service API
Authentication
All API requests require API Key via X-API-Key header.
How to get API Key: Contact admin for API key with expiry date.
curl -H "X-API-Key: your-api-key-here" https://emailqu.com/api/emails/test@example.com
GET
/api/emails/:address
Get all emails for specific address.
Parameters:
address- Full email address (required)
Example Request:
curl -H "X-API-Key: your-api-key" \ https://emailqu.com/api/emails/test@emailqu.com
Response:
{
"success": true,
"emails": [
{
"id": "abc123",
"from": "sender@example.com",
"to": "test@emailqu.com",
"subject": "Welcome!",
"body": "Email content...",
"html": "<p>HTML content</p>",
"received_at": "2025-01-15T10:30:00Z"
}
]
}
GET
/api/emails/:address/:id
Get specific email by ID.
Parameters:
address- Email addressid- Email ID
Example Request:
curl -H "X-API-Key: your-api-key" \ https://emailqu.com/api/emails/test@emailqu.com/abc123
Python Example
import requests
API_KEY = "your-api-key"
EMAIL = "test@emailqu.com"
headers = {"X-API-Key": API_KEY}
response = requests.get(
f"https://emailqu.com/api/emails/{EMAIL}",
headers=headers
)
if response.status_code == 200:
data = response.json()
print(f"Found {len(data['emails'])} emails")
for email in data['emails']:
print(f"From: {email['from']}")
print(f"Subject: {email['subject']}")
else:
print(f"Error: {response.status_code}")
JavaScript Example (Node.js)
const API_KEY = "your-api-key";
const EMAIL = "test@emailqu.com";
fetch(`https://emailqu.com/api/emails/${EMAIL}`, {
headers: {
'X-API-Key': API_KEY
}
})
.then(res => res.json())
.then(data => {
console.log(`Found ${data.emails.length} emails`);
data.emails.forEach(email => {
console.log(`From: ${email.from}`);
console.log(`Subject: ${email.subject}`);
});
})
.catch(err => console.error('Error:', err));
Rate Limiting
Limit: 100 requests per minute per API key
Status if exceeded: 429 Too Many Requests
Error Codes
| Code | Description |
|---|---|
200 |
Success |
401 |
Invalid API Key |
404 |
Email not found |
429 |
Too many requests |
500 |
Server error |
Have questions? Contact support or read full documentation on GitHub.