Free API Docs

Build your own throwaway email integrations. Perfect for QA automation, CI/CD testing pipelines, and OTP verifications. 100% free with real D1 edge responses.

Global Edge

Deployed on Cloudflare Pages and D1 SQLite edge database, ensuring ultra-low latency globally.

No API Keys Required

Start making REST API calls immediately. Zero signups, zero credit cards, completely open.

CORS Enabled

Standard CORS enabled (`Access-Control-Allow-Origin: *`) so you can query from any browser app or backend script.

Live API Console (Test Now)

GET

1. Get Active Domains

Fetch all available domain names managed on the server. Use this to dynamically populate domain options in your applications.

GET https://trytempmail.co/api/domains

cURL Example

curl -X GET https://trytempmail.co/api/domains

JSON Response (200 OK)

{
  "domains": [
    {
      "id": "dom_1",
      "domain": "trytempmail.co",
      "is_active": 1,
      "created_at": "2026-08-22T09:00:00.000Z"
    }
  ]
}
GET

2. Fetch Mailbox Emails

Retrieve all received emails for a given disposable email address. All messages include parsed clean text and full HTML body.

GET https://trytempmail.co/api/emails?address=user@trytempmail.co

Node.js (Fetch) Example

const email = "sewiadwx@trytempmail.co";
const res = await fetch(`https://trytempmail.co/api/emails?address=${encodeURIComponent(email)}`);
const data = await res.json();
console.log(data.emails);

Python Example

import requests

email = "sewiadwx@trytempmail.co"
response = requests.get(f"https://trytempmail.co/api/emails?address={email}")
emails = response.json().get("emails", [])
for msg in emails:
    print(f"From: {msg['sender']} | Subject: {msg['subject']}")

JSON Response (200 OK)

{
  "emails": [
    {
      "id": "c1f76239-6e3e-4fa0-82a1-12c8b0561571",
      "recipient": "sewiadwx@trytempmail.co",
      "sender": "Wise <noreply@wise.com>",
      "subject": "Your Wise verification code is 492011",
      "body_text": "Use code 492011 to verify your identity.",
      "body_html": "<div><h2>Your Wise verification code is 492011</h2>...</div>",
      "date": "2026-08-22T23:55:00.000Z",
      "received_at": "2026-08-22T23:55:01.000Z"
    }
  ]
}
DELETE

3. Delete Single Email

Permanently remove an email message from Cloudflare D1 storage using its unique ID.

DELETE https://trytempmail.co/api/emails?id={email_id}

cURL Example

curl -X DELETE "https://trytempmail.co/api/emails?id=c1f76239-6e3e-4fa0-82a1-12c8b0561571"