shipapis
StarSubmit an APISubmit API

mail.tm

Spin up throwaway inboxes over a JSON:LD REST API

💬 Social & WorkHEALTHYchecked 9h ago
AUTH NONECORS ✗AGENT ✓HTTPS ✓COMMERCIAL ?

mail.tm is a temporary-email service with a clean REST API for creating disposable mailboxes and reading messages. The /domains endpoint lists which mail domains are currently available to register against, and it needs no authentication. Responses come back as Hydra/JSON-LD collections.

82HOW IT'S SCORED ⓘ
Docs ↗
Status badge · for your READMEshipapis health badge: 82 · healthy
Uptime history
84.3%90 days
75.0%30 days
709P50 · ms
2351P95 · ms
operationalpartialdownno data
Response time · last 48 checks
Fastest 80 ms, slowest 1670 ms, most recent 94 ms.
Live response samplecaptured by our last successful check
GET https://api.mail.tm/domains

{
  "@context": "/contexts/Domain",
  "@id": "/domains",
  "@type": "hydra:Collection",
  "hydra:totalItems": 1,
  "hydra:member": [
    {
      "@type": "Domain",
      "domain": "web-library.net",
      "isActive": true,
      "isPrivate": false
    }
  ]
}
Call itcurl · fetch · python
curl "https://api.mail.tm/domains"
const res = await fetch("https://api.mail.tm/domains");
const data = await res.json();
console.log(data);
import requests

res = requests.get("https://api.mail.tm/domains")
print(res.json())

BROWSER CALLS BLOCKED (NO CORS/HTTPS) — USE THE CURL SNIPPET

Endpoints · 6HealthyFULL DOCS ↗
Monitored path responding — GET /domains709 mschecked 9h ago
GET/domainsPROBED

Spin up throwaway inboxes over a JSON:LD REST API

GET/domains?limit=5

Paginated variant with limit parameter.

GET/accounts

Accounts — documented GET route.

GET/token

Token — documented GET route.

GET/messages

Messages — documented GET route.

GET/docs.jsonld

Docs Jsonld — documented GET route.

Machine-readable spec

We probe a documented GET and expect 2xx JSON — full uptime and health score. Export includes every documented route below.

Response-shape history

Stable. No schema drift observed since monitoring began — the response shape has not changed under our checks.

mail.tm: common questions

Is mail.tm free to use?

Yes — mail.tm is a free social & work API. Free tier: Free — temporary mailboxes. Whether the free tier allows commercial use is unclear — check the provider docs.

Does mail.tm need an API key?

No — mail.tm needs no API key or signup. You can call it straight away; rate limits still apply (Rate limited (429 on exceed); exact policy per docs.mail.tm).

Can I call mail.tm from the browser?

Not directly — mail.tm doesn't send browser-friendly CORS headers, so call it from a server or proxy instead. Copy the curl or Python snippet on this page to get started.

Is mail.tm up right now?

As of our last scheduled check, mail.tm is healthy with 84.3% uptime over 90 days and a 709 ms median response. We re-probe it every sweep — the status badge and uptime chart above always show the latest.