Temp Mail API

Create disposable inboxes and read incoming mail programmatically — free, no API key required.

Base URL

https://api1.mohmol.org

1. List available domains

Get the domains you can create addresses on.

GET/api/domains

2. Create an address

Generate a random address. Optionally pass a domain from the list above; otherwise the default domain is used.

POST/api/generate-email

3. Read the inbox

Fetch messages received by an address — sender, subject and decoded text/HTML content.

GET/api/emails/{address}

4. Delete the inbox

Delete all messages stored for an address.

DELETE/api/delete/{address}

Quick example

# 1) list available domains
curl https://api1.mohmol.org/api/domains

# 2) create an address (optionally choose a domain)
curl -X POST https://api1.mohmol.org/api/generate-email \
  -H "Content-Type: application/json" \
  -d '{"domain":"trythisemail.org"}'

# 3) read received emails for that address
curl https://api1.mohmol.org/api/emails/[email protected]

Rate limits

Limited per IP: up to 150 requests per minute overall, and 30 per minute for address creation/deletion. Exceeding a limit returns HTTP 429 with a Retry-After header.

Addresses must use a domain returned by /api/domains that has email routing enabled. Messages auto-expire after a period of inactivity.