De abonnementen voor de API openen binnenkort. Wil je nu al meetesten? Mail ons op [email protected].
Zo werkt het
Met een Dev- of Team-abonnement krijg je een eigen namespace, bijvoorbeeld acme.nmail.nl. Alle mail naar [email protected] komt binnen in je account. Je hoeft adressen niet vooraf aan te maken: de inbox ontstaat bij de eerste mail. Adressen met een +tag zijn aparte inboxen, handig om testruns uit elkaar te houden.
Authenticatie
Maak een API-sleutel aan in je account en stuur hem mee als Bearer-token:
Authorization: Bearer <je-api-sleutel>
Limiet: 120 verzoeken per minuut per account.
Endpoints
| Verzoek | Wat |
|---|---|
GET /api/v1/namespaces | Je namespaces. |
GET /api/v1/messages?to=&since=&limit= | Laatste berichten, optioneel per adres en vanaf een tijdstip (ISO 8601). Maximaal 100. |
GET /api/v1/messages/wait?to=&since=&timeout= | Wacht op het eerste bericht voor een adres na since. Geeft 200 met het bericht of 204 als er binnen timeout seconden (max. 25) niets kwam. |
GET /api/v1/messages/{id} | Volledig bericht met tekst, HTML, gevonden links en codes. |
DELETE /api/v1/messages/{id} | Bericht verwijderen. |
Links en codes
Bij elk volledig bericht staan links (alle http(s)-links, in volgorde) en codes (losse getallen van 4 tot 8 cijfers, zonder datums, tijden of cijfers uit links). Zo pak je een verificatielink of eenmalige code zonder zelf HTML te parsen.
Voorbeeld: curl
START=$(date -u +%Y-%m-%dT%H:%M:%SZ)
# ... laat je app een mail sturen naar [email protected] ...
curl -s -H "Authorization: Bearer $TEMPMAIL_TOKEN" \
"https://tempmail.nl/api/v1/messages/wait?to=signup%[email protected]&since=$START&timeout=20" \
| jq -r '.data.codes[0]'
Voorbeeld: Playwright
const since = new Date().toISOString();
await page.fill('#email', '[email protected]');
await page.click('button[type=submit]');
const res = await fetch(`https://tempmail.nl/api/v1/messages/wait?to=${encodeURIComponent('[email protected]')}&since=${since}&timeout=20`, {
headers: { Authorization: `Bearer ${process.env.TEMPMAIL_TOKEN}` },
});
if (res.status === 204) throw new Error('Geen mail ontvangen');
const { data } = await res.json();
await page.goto(data.links.find((l) => l.includes('/verify')));
Bewaartermijn en limieten
- Berichten in namespaces blijven 7 dagen bewaard.
- Dev: 1 namespace, 5.000 berichten per maand. Team: 5 namespaces, 50.000 berichten per maand.
- Maximaal 10 MB per bericht, bijlagen tot 5 MB.
- Alleen ontvangen. Er wordt nooit mail verstuurd vanaf deze adressen.