Developer Platform

TempoMail Developer API v1

Integrate high-speed, disposable temporary emails and web-ready inboxes directly into your applications, automated testing suites, and registration workflows.

Launch Playground View API Plans
API Status: 100% Operational
Base URL:
https://tempomailusa.com/v1
Rate Limit: 60 req/min
Auth Header: X-API-Key: tm_live_...
Sign in to generate an API key

Domain API access requires an active account with a Domain API Access plan subscription ($9/mo or $79/yr).

Sign in View Plans

API Reference & Endpoints

GET /domains/{type?}

Fetch active domains available for generating temporary mailboxes. Optional type parameter can be all, free, or premium.

cURL Example:
curl -X GET "https://tempomailusa.com/v1/domains/all" \
  -H "X-API-Key: YOUR_API_KEY"
POST /emails

Generate a new temporary email address. Optional JSON payload accepts custom username and domain.

cURL Example:
curl -X POST "https://tempomailusa.com/v1/emails" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "tester123", "domain": "tempomailusa.com"}'
POST /emails/{email}/{username}/{domain}

Update or change an existing temporary email address to a custom username and domain.

cURL Example:
curl -X POST "https://tempomailusa.com/v1/emails/old@tempomailusa.com/newuser/tempomailusa.com" \
  -H "X-API-Key: YOUR_API_KEY"
DELETE /emails/{email}

Permanently delete a temporary mailbox and invalidate its tokens.

cURL Example:
curl -X DELETE "https://tempomailusa.com/v1/emails/tester123@tempomailusa.com" \
  -H "X-API-Key: YOUR_API_KEY"
GET /messages/{email}

Retrieve all incoming emails received by the specified temporary address.

cURL Example:
curl -X GET "https://tempomailusa.com/v1/messages/tester123@tempomailusa.com" \
  -H "X-API-Key: YOUR_API_KEY"
GET /messages/{email}/{messageId}

Retrieve the full body (HTML + Plaintext) and attachments of a specific message.

cURL Example:
curl -X GET "https://tempomailusa.com/v1/messages/tester123@tempomailusa.com/42" \
  -H "X-API-Key: YOUR_API_KEY"
DELETE /messages/{email}/{messageId}

Permanently remove a single message from the mailbox.

cURL Example:
curl -X DELETE "https://tempomailusa.com/v1/messages/tester123@tempomailusa.com/42" \
  -H "X-API-Key: YOUR_API_KEY"
GET /account

Check your developer account quota, active plan details, and rate limits.

cURL Example:
curl -X GET "https://tempomailusa.com/v1/account" \
  -H "X-API-Key: YOUR_API_KEY"