✉ Temp Mail

Open API

Maak tijdelijke inboxen aan en lees e-mails met een eenvoudige HTTP-API, ideaal voor geautomatiseerde tests en het controleren van aanmeldingen. Alle endpoints geven JSON terug.

Authenticatie

Bij het aanmaken van een inbox krijg je een token terug. Stuur dit mee bij volgende verzoeken:

Authorization: Bearer <token>

Limieten

Zonder API-sleutel kan elk IP-adres tot 10 inboxen per minuut aanmaken. Voor hogere limieten stuur je een API-sleutel mee bij het aanmaken:

X-API-Key: tm_xxxxxxxxxxxxxxxx

Endpoints

MethodePadBeschrijving
GET/api/domainsBeschikbare domeinen tonen
POST/api/mailboxInbox aanmaken. Lege body voor een willekeurig adres, of {"local":"abc","domain":"…"} voor een eigen adres
GET/api/mailboxInfo over de huidige inbox
DELETE/api/mailboxInbox en alle e-mails verwijderen
GET/api/messagesInbox tonen (laatste 100)
GET/api/messages/{id}E-mail ophalen (inhoud en bijlagen)
DELETE/api/messages/{id}E-mail verwijderen
GET/api/messages/{id}/rawOriginele .eml downloaden
GET/api/attachments/{id}Bijlage downloaden
GET/api/eventsSSE-eventstream, stuurt event: mail bij nieuwe e-mails

Voorbeelden

# 1. Inbox aanmaken. Lege body voor een willekeurig adres, of {"local":"abc","domain":"…"} voor een eigen adres
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
  -H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}

# 2. Inbox tonen (laatste 100)
curl -s https://www.temp-mail.cc/api/messages \
  -H 'Authorization: Bearer <token>'

# 3. E-mail ophalen (inhoud en bijlagen)
curl -s https://www.temp-mail.cc/api/messages/123 \
  -H 'Authorization: Bearer <token>'
# Python
import requests, time
base = "https://www.temp-mail.cc"
mb = requests.post(f"{base}/api/mailbox", json={}).json()
headers = {"Authorization": f"Bearer {mb['token']}"}
print(mb["address"])
while True:
    msgs = requests.get(f"{base}/api/messages", headers=headers).json()["messages"]
    if msgs:
        print(requests.get(f"{base}/api/messages/{msgs[0]['id']}", headers=headers).json()["text"])
        break
    time.sleep(3)

Fouten

Bij een fout wordt een niet-2xx-status met JSON-body teruggegeven:

{"error": "rate_limited", "message": "…"}

← Terug naar home