Temp Mail API-Schlüssel für automatisierte E-Mail-Tests

Aktive öffentliche Domains auflisten

Liefert die aktuell zur Adressgenerierung verfügbaren Domains. Dieser öffentliche Helfer erfordert keinen API-Schlüssel und verbraucht kein Kontingent. Private GPTMail-Domains sind ausgeschlossen.

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
  }
}

Temporäre E-Mail-Adresse generieren

GET erzeugt eine Adresse mit generiertem Präfix und zufälliger aktiver Domain. POST erlaubt die optionale Wahl von Präfix, Domain oder beidem. Die endgültige Adresse steht immer in 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"

Ist die angeforderte Domain nicht mehr aktiv, liefert die API HTTP 409, statt unbemerkt eine andere Domain zu wählen.

Nachrichten eines Postfachs auflisten

Liefert bis zu den neuesten 500 Nachrichten einer öffentlichen CleanTempMail-Adresse. Ein neues oder leeres Postfach liefert emails: [] und 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 }
}

Eine vollständige Nachricht abrufen

Verwendet die von /api/emails gelieferte id zum Abrufen von Text/HTML, Headern, Zeitstempeln und Anhangmetadaten. Die Binärdaten der Anhänge sind nicht im JSON enthalten.

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

Wichtige E-Mail-Felder

Anhang herunterladen

Lädt einen Anhang als Binärdatei herunter. Verwenden Sie die Nachrichten-id und attachments[].id aus GET /api/email/{id}. Jeder Download verbraucht 1 API-Anfrage.

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

Der Antwortinhalt ist die Datei. Der Server setzt Content-Type, Content-Length und Content-Disposition. curl -OJ speichert den sicheren, vom Server gelieferten Dateinamen. Anhangfehler werden als Klartext zurückgegeben.

Eine Nachricht löschen

Löscht die durch id bezeichnete Nachricht dauerhaft. Rufen Sie die ID zuerst über /api/emails ab. Dies kann nicht rückgängig gemacht werden.

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}}

Postfach leeren

Löscht sämtliche gespeicherten Nachrichten des angegebenen öffentlichen Postfachs dauerhaft und liefert deren Anzahl. Dies kann nicht rückgängig gemacht werden.

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}}

Statistik-Endpunkte

Liefert zwischengespeicherte öffentliche Dienststatistiken. Jeder Pfad ist eine separate geschützte Anfrage und verbraucht 1 Anfrage. E-Mails privater Domains sind von öffentlichen Statistiken ausgeschlossen.

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 }
}

Kontingent eines API-Schlüssels prüfen

Liefert Status und Verbrauch für gekaufte, manuell erstellte, aufgebrauchte oder gemeinsame Testschlüssel, ohne Kontingent zu verbrauchen. Übergeben Sie den Schlüssel vorzugsweise in X-API-Key oder im JSON-Feld 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 ist active, exhausted oder inactive. Aufgebrauchte gekaufte Schlüssel bleiben abfragbar. Der vollständige Schlüssel und Stripe-/Kundenmetadaten werden niemals zurückgegeben.