Temp Mail API-sleutels voor geautomatiseerde e-mailtests

Actieve openbare domeinen tonen

Geeft de domeinen terug die beschikbaar zijn om adressen te genereren. Deze openbare functie vereist geen API-sleutel en verbruikt geen tegoed. Privédomeinen van GPTMail zijn uitgesloten.

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

Tijdelijk e-mailadres genereren

GET maakt een adres met een gegenereerd voorvoegsel en een willekeurig actief domein. POST laat u optioneel het voorvoegsel, domein of beide kiezen. Het uiteindelijke adres staat altijd 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"

Als het gevraagde domein niet meer actief is, geeft de API HTTP 409 terug in plaats van ongemerkt een ander domein te kiezen.

Berichten in een postvak tonen

Geeft maximaal de 500 nieuwste berichten van één openbaar CleanTempMail-adres terug. Een nieuw of leeg postvak geeft emails: [] en count: 0 terug.

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

Eén volledig bericht ophalen

Gebruikt de id uit /api/emails om tekst/HTML, headers, tijdstempels en bijlagemetadata op te halen. Binaire bijlagegegevens zijn niet opgenomen in JSON.

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

Belangrijke e-mailvelden

Bijlage downloaden

Download één bijlage als binair bestand. Gebruik de bericht-id en attachments[].id uit GET /api/email/{id}. Elke download verbruikt 1 API-aanvraag.

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

De antwoordinhoud is het bestand zelf. De server stelt Content-Type, Content-Length en Content-Disposition in. curl -OJ slaat de veilige bestandsnaam van de server op. Bijlagefouten worden als platte tekst teruggegeven.

Eén bericht verwijderen

Verwijdert het bericht met de opgegeven id permanent. Haal de ID eerst op via /api/emails. Dit kan niet ongedaan worden gemaakt.

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

Postvak leegmaken

Verwijdert alle opgeslagen berichten van het opgegeven openbare postvak permanent en geeft het verwijderde aantal terug. Dit kan niet ongedaan worden gemaakt.

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

Statistiek-endpoints

Geeft gecachte openbare dienststatistieken terug. Elk pad is een afzonderlijke beschermde aanvraag en verbruikt 1 aanvraag. E-mail van privédomeinen is uitgesloten van openbare statistieken.

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

Tegoed van API-sleutel controleren

Geeft status en gebruik terug voor gekochte, handmatig aangemaakte, opgebruikte of gedeelde testsleutels, zonder tegoed te verbruiken. Verstuur de sleutel bij voorkeur in X-API-Key, of in het JSON-veld 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 is active, exhausted of inactive. Opgebruikte gekochte sleutels blijven opvraagbaar. De volledige sleutel en Stripe-/klantmetadata worden nooit teruggegeven.