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 address
  • id - 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.