What to Expect

Secure Authentication

API keys managed securely through your dashboard with fine-grained access control.

High Performance

Lightning-fast response times with 99.9% uptime guarantee for production workloads.

Comprehensive Docs

Detailed documentation with code examples in multiple programming languages.

Usage Analytics

Real-time analytics and monitoring of your API usage directly in your dashboard.

API Endpoints (Preview)

POST /api/v1/email/create

Create a new temporary email address

{
  "domain": "example.com",
  "prefix": "custom-prefix"
}

GET /api/v1/email/{address}/messages

Retrieve all messages for an email address

{
  "messages": [...],
  "count": 5
}

DELETE /api/v1/email/{address}

Delete a temporary email address

{
  "success": true,
  "message": "Email deleted"
}

PATCH /api/v1/email/{address}/extend

Extend the lifetime of an email address

{
  "success": true,
  "new_expiry": "2025-10-16T10:00:00Z"
}

Quick Start Example

const response = await fetch('https://easytrashmail.com/api/v1/email/create', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    domain: 'example.com',
    prefix: 'test'
  })
});

const data = await response.json();
console.log('Email created:', data.email);

import requests

response = requests.post(
    'https://easytrashmail.com/api/v1/email/create',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'domain': 'example.com',
        'prefix': 'test'
    }
)

data = response.json()
print(f"Email created: {data['email']}")

$ch = curl_init('https://easytrashmail.com/api/v1/email/create');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'domain' => 'example.com',
    'prefix' => 'test'
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response);
echo "Email created: {$data->email}";

curl -X POST https://easytrashmail.com/api/v1/email/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "example.com",
    "prefix": "test"
  }'

API Documentation

API Access Coming Soon