Des clés API Temp Mail pour automatiser vos tests d’e-mails

Lister les domaines publics actifs

Renvoie les domaines actuellement disponibles pour générer des adresses. Cet outil public ne nécessite aucune clé et ne consomme pas de quota. Les domaines privés GPTMail sont exclus.

curl -sS "https://cleantempmail.com/api/domains?limit=100"

{
  "success": true,
  "data": {
    "domains": ["domain-one.example", "domain-two.example"],
    "total": 1832,
    "offset": 0,
    "limit": 100
  }
}

Générer une adresse e-mail temporaire

GET crée une adresse avec un préfixe généré et un domaine actif aléatoire. POST permet de choisir le préfixe, le domaine ou les deux. L’adresse finale est toujours renvoyée dans data.email.

curl -sS \
  -H "X-API-Key: ct-test" \
  "https://cleantempmail.com/api/generate-email"

curl -sS -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"prefix":"qa.user","domain":"your-active-domain.com"}' \
  "https://cleantempmail.com/api/generate-email"

Si le domaine demandé n’est plus actif, l’API renvoie HTTP 409 au lieu d’en choisir un autre silencieusement.

Lister les messages d’une boîte

Renvoie jusqu’aux 500 messages les plus récents d’une adresse publique CleanTempMail. Une boîte nouvelle ou vide renvoie emails: [] et count: 0.

curl -sS -G \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "[email protected]" \
  "https://cleantempmail.com/api/emails"

{
  "success": true,
  "data": {
    "emails": [
      {
        "id": "66c123example",
        "email_address": "[email protected]",
        "from_address": "[email protected]",
        "subject": "Your verification code",
        "content": "Your code is 123456",
        "html_content": "<p>Your code is <b>123456</b></p>",
        "has_html": true,
        "attachments": [
          {
            "id": "attachment-id",
            "filename": "receipt.pdf",
            "content_type": "application/pdf",
            "size": 48231
          }
        ],
        "timestamp": 1787702400,
        "raw_size": 51984,
        "created_at": "2026-08-25T12:00:00Z"
      }
    ],
    "count": 1
  },
  "usage": { "daily_limit": 100, "used_today": 2, "remaining_today": 98, "total_limit": 1000, "total_used": 2, "remaining_total": 998 }
}

Récupérer un message complet

Utilise l’id renvoyé par /api/emails pour récupérer le texte/HTML, les en-têtes, les horodatages et les métadonnées des pièces jointes d’un message. Le contenu binaire des pièces jointes n’est pas inclus dans le JSON.

curl -sS \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://cleantempmail.com/api/email/66c123example"

Principaux champs d’un e-mail

Télécharger une pièce jointe

Télécharge une pièce jointe sous forme de fichier binaire. Utilisez l’id du message et attachments[].id renvoyés par GET /api/email/{id}. Chaque téléchargement consomme 1 requête API.

curl -fL -OJ \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://cleantempmail.com/api/email/66c123example/attachment/attachment-id"

Le corps de la réponse contient le fichier. Le serveur définit Content-Type, Content-Length et Content-Disposition. curl -OJ enregistre le nom de fichier sûr fourni par le serveur. Les erreurs de pièce jointe sont renvoyées en texte brut.

Supprimer un message

Supprime définitivement le message désigné par id. Obtenez cet identifiant via /api/emails. Cette action est irréversible.

curl -sS -X DELETE \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://cleantempmail.com/api/email/66c123example"

{"success":true,"data":{"message":"Email deleted"},"usage":{"daily_limit":100,"used_today":4,"remaining_today":96,"total_limit":1000,"total_used":4,"remaining_total":996}}

Vider une boîte

Supprime définitivement tous les messages stockés pour la boîte publique indiquée et renvoie le nombre supprimé. Cette action est irréversible.

curl -sS -X DELETE -G \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "[email protected]" \
  "https://cleantempmail.com/api/emails/clear"

{"success":true,"data":{"message":"Deleted 3 emails","count":3},"usage":{"daily_limit":100,"used_today":5,"remaining_today":95,"total_limit":1000,"total_used":5,"remaining_total":995}}

Endpoints statistiques

Renvoie les statistiques publiques mises en cache. Chaque chemin constitue une requête protégée distincte et consomme 1 requête. Les messages des domaines privés sont exclus des statistiques publiques.

curl -sS \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://cleantempmail.com/api/stats"

{
  "success": true,
  "data": {
    "total_emails": 1250000,
    "today_emails": 32000,
    "emails_24h": 41000,
    "unique_subjects": 8600,
    "active_domains": 1832
  },
  "usage": { "daily_limit": 100, "used_today": 6, "remaining_today": 94, "total_limit": 1000, "total_used": 6, "remaining_total": 994 }
}

Vérifier le quota d’une clé API

Renvoie l’état et l’utilisation d’une clé achetée, créée manuellement, épuisée ou de test partagée. Cette consultation ne consomme pas de quota. Fournissez la clé dans X-API-Key, méthode recommandée, ou dans le champ JSON api_key.

curl -sS -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://cleantempmail.com/api/api-key/usage"

curl -sS -X POST \
  -H "Content-Type: application/json" \
  --data '{"api_key":"ct-test"}' \
  "https://cleantempmail.com/api/api-key/usage"

{
  "success": true,
  "data": {
    "masked_key": "••••••••wxyz",
    "status": "active",
    "is_active": true,
    "daily_limit": 100,
    "used_today": 6,
    "remaining_today": 94,
    "total_limit": 1000,
    "total_used": 6,
    "remaining_total": 994
  }
}

status vaut active, exhausted ou inactive. Les clés achetées épuisées restent consultables. La clé complète et les métadonnées Stripe/client ne sont jamais renvoyées.