Développeur

Développez avec l'API TempMail

Créez des boîtes de réception et récupérez des codes de validation via HTTP. Commencez immédiatement sans compte ou créez une clé d'API pour débloquer les fonctionnalités Pro.

Sans connexion · Sans clé d'API

Commencez dès maintenant, de façon anonyme

La même API que celle qui propulse l'application web TempMail. Chaque boîte de réception reçoit une adresse aléatoire et a une durée de vie de 24 heures.

  1. 1POST /accounts crée une boîte de réception avec une adresse et un mot de passe aléatoires.
  2. 2POST /token échange l'adresse et le mot de passe contre un jeton de boîte de réception tm_box_.
  3. 3GET /messages renvoie les e-mails entrants avec les codes de validation déjà extraits.
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,…}
Consulter la référence complète de l'API
Pro

Clé d'API pour les fonctionnalités Pro

Une clé d'API tm_live_ est associée à votre compte TempMail. Tant que votre compte est sur le forfait Pro, cette même clé débloque automatiquement :

  • Adresses personnalisées : envoyez POST /accounts avec votre clé et un champ "address"
  • Limites plus élevées : 20 requêtes/seconde et 1000 nouvelles boîtes de réception par jour
  • Jusqu'à 10 adresses privées qui n'expirent pas
  • Rétention des e-mails de 30 jours et 100 MB de stockage

Les comptes gratuits peuvent aussi créer une clé. Elle fonctionne comme l'API anonyme jusqu'à votre mise à niveau, sans modification de code nécessaire.