Ontwikkelaars

Bouw met de TempMail API

Maak inboxen aan en lees verificatiecodes uit via HTTP. Begin direct zonder account, of maak een API-sleutel aan om Pro-functies te ontgrendelen.

Geen login · Geen API-sleutel

Start direct, anoniem

Dezelfde API die de TempMail-webapp aandrijft. Elke mailbox krijgt een willekeurig adres en blijft 24 uur actief.

  1. 1POST /accounts maakt een mailbox aan met een willekeurig adres en wachtwoord.
  2. 2POST /token wisselt het adres en wachtwoord in voor een tm_box_-mailboxtoken.
  3. 3GET /messages retourneert inkomende e-mail waaruit verificatiecodes al zijn geëxtraheerd.
BASE=https://www.tempmail.ai/api/v1

# 1. Create a mailbox (random address + password)
curl -s -X POST "$BASE/accounts" \
  -H "Content-Type: application/json" -d '{}'
# {"id":"…","address":"k3x9m2q7…@tempmail.ai","password":"…","expires_at":"…"}

# 2. Exchange the credentials for a mailbox token
curl -s -X POST "$BASE/token" \
  -H "Content-Type: application/json" \
  -d '{"address":"ADDRESS","password":"PASSWORD"}'
# {"id":"…","token":"tm_box_…","token_type":"Bearer","expires_at":"…"}

# 3. Read messages – verification codes are already extracted
curl -s "$BASE/messages" -H "Authorization: Bearer TOKEN"
# {"items":[{"from":"[email protected]","subject":"Your verification code","verification_code":"482913",…}],"total":1,…}
Lees de volledige API-referentie
Pro

API-sleutel voor Pro-functies

Een tm_live_-API-sleutel is gekoppeld aan je TempMail-account. Zolang je account Pro heeft, ontgrendelt dezelfde sleutel automatisch:

  • Aangepaste adressen: verstuur POST /accounts met je sleutel en een "address"-veld
  • Hogere limieten: 20 verzoeken/seconde en 1000 nieuwe mailboxen per dag
  • Tot wel 10 privéadressen die niet verlopen
  • Bewaartermijn van 30 dagen voor e-mail en 100 MB opslag

Gratis accounts kunnen ook een sleutel aanmaken. Deze werkt hetzelfde als de anonieme API totdat je upgradet, zonder dat er codewijzigingen nodig zijn.