Zum Inhalt springen
Doku

Verifizierungslisten

Bis zu 10.000 Adressen auf einmal verifizieren und die Ergebnisse exportieren.

Basis-URLhttps://api.emailit.com/v2AuthentifizierungFehlerRate Limits

Liste erstellen

Erstellt eine Verifizierungsliste und beginnt im Hintergrund, ihre Adressen zu verifizieren. Jede Adresse wird im Modus full geprüft, einschließlich der Postfachprüfung, die unter Adresse verifizieren beschrieben ist. Erfordert einen API-Schlüssel mit dem Scope full.

POST/email-verification-lists

Anfrage-Body

namestringErforderlich

Name der Liste, 1 bis 255 Zeichen.

emailsstring[]Erforderlich

Zu verifizierende Adressen, 1 bis 10.000. Jeder Eintrag muss eine gültige E-Mail-Adresse sein. Emailit entfernt Leerzeichen am Anfang und Ende, schreibt die Adressen klein und entfernt Duplikate.

Rückgabe

Gibt 201 Created mit der Liste zurück. Emailit berechnet 5 Credits pro eindeutiger Adresse, bevor die Verifizierung beginnt. Die Antwort meldet, wie viele Adressen angenommen wurden (valid_emails_count, unique_emails_count) und wie viele Verifizierungsjobs in die Warteschlange gestellt wurden (dispatched_jobs). Die neue Liste hat den Status processing.

stats wird aktualisiert, sobald eine Adresse fertig ist. Hat jede Adresse ein endgültiges Ergebnis, wechselt die Liste zu completed. Fragen Sie Liste abrufen regelmäßig ab oder warten Sie auf Webhook-Events:

Status Wann
400 name oder emails fehlt oder ist leer, emails hat mehr als 10.000 Einträge oder ein Eintrag ist keine gültige Adresse (Standard-Validierungsfehler).
402 Der Workspace hat nicht genug Credits für alle eindeutigen Adressen.

Statistiken

Feld Beschreibung
total_emails Eindeutige Adressen in der Liste.
processed_emails Abgeschlossene Adressen, mit einem Ergebnis oder einem Fehler.
successful_verifications Adressen mit einem endgültigen Ergebnis, gleich welchem. Das heißt nicht, dass die Adressen gültig sind; siehe results.
failed_verifications Adressen, deren Prüfung ein Fehler verhindert hat.
pending_emails Noch nicht abgeschlossene Adressen, einschließlich solcher, die auf eine Wiederholung nach Greylisting warten.
results Abgeschlossene Adressen nach Ergebnis: safe, role, catch_all, unknown, inbox_full, disabled, disposable und invalid. Ältere Listen haben dieses Feld möglicherweise nicht.
POST/email-verification-lists
Terminal
curl -X POST https://api.emailit.com/v2/email-verification-lists \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "October newsletter import", "emails": ["ada@example.com", "grace@example.com"]}'
JSON
{
  "id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
  "name": "October newsletter import",
  "valid_emails_count": 2,
  "unique_emails_count": 2,
  "invalid_emails_count": 0,
  "status": "processing",
  "dispatched_jobs": 2,
  "stats": {
    "total_emails": 2,
    "processed_emails": 0,
    "successful_verifications": 0,
    "failed_verifications": 0,
    "pending_emails": 2,
    "results": {
      "safe": 0,
      "role": 0,
      "catch_all": 0,
      "unknown": 0,
      "inbox_full": 0,
      "disabled": 0,
      "disposable": 0,
      "invalid": 0
    }
  },
  "created_at": "2026-10-01T10:30:02.441000+00:00"
}

Listen auflisten

Gibt Ihre E-Mail-Verifizierungslisten zurück, neueste zuerst. Erfordert einen API-Schlüssel mit dem Scope full.

GET/email-verification-lists

Query-Parameter

pageinteger

Seitennummer, beginnend bei 1. Standardwert 1.

limitinteger

Listen pro Seite, von 1 bis 100. Standardwert 10.

statusstring

Nur Listen mit diesem Status: pending, processing, completed, failed oder canceled.

searchstring

Abgleich mit dem Namen der Liste, ohne Beachtung der Groß-/Kleinschreibung.

matchstring

all (Standardwert) verlangt, dass alle Filter zutreffen. or trifft zu, wenn ein beliebiger Filter passt. Siehe Filtern und Sortieren.

orderstring

Sortierschlüssel für diese Liste. Siehe die Sortierschlüssel unten.

directionstring

asc oder desc.

Filter und Sortierung

Listenfilter sind Query-Parameter der Form key.condition=value auf einer einzigen Ebene. match, order, direction und die Bedingungen pro Typ finden Sie unter Filtern und Sortieren.

Filterschlüssel

SchlüsselTypBedingungenHinweise
namestringexact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty
statusstringexact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty
created_atdateexact, before, after, empty, not_empty

Sortierschlüssel

Übergeben Sie in order einen dieser Schlüssel und in direction den Wert asc oder desc: name, status, created_at

Rückgabe

Gibt 200 OK mit den Listen in data zurück, dazu next_page_url und previous_page_url (null am jeweiligen Ende). Jede Liste hat id, name, status, stats, created_at und updated_at; die Felder von stats finden Sie unter Liste erstellen.

GET/email-verification-lists
Terminal
curl -X GET https://api.emailit.com/v2/email-verification-lists \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json"
JSON
{
  "data": [
    {
      "id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
      "name": "October newsletter import",
      "status": "completed",
      "stats": {
        "total_emails": 1000,
        "processed_emails": 1000,
        "successful_verifications": 996,
        "failed_verifications": 4,
        "pending_emails": 0,
        "results": {
          "safe": 702,
          "role": 41,
          "catch_all": 88,
          "unknown": 37,
          "inbox_full": 3,
          "disabled": 6,
          "disposable": 12,
          "invalid": 107
        }
      },
      "created_at": "2026-10-01T10:30:02.441000+00:00",
      "updated_at": "2026-10-01T10:41:57.020000+00:00"
    }
  ],
  "next_page_url": "/v2/email-verification-lists?page=2&limit=10",
  "previous_page_url": null
}

Liste abrufen

Gibt eine E-Mail-Verifizierungsliste zurück. Fragen Sie den Endpunkt regelmäßig ab, um zu erfahren, wann eine Liste den Status completed hat, oder warten Sie stattdessen auf das Webhook-Event email_verification_list.updated. Erfordert einen API-Schlüssel mit dem Scope full.

GET/email-verification-lists/:id

Pfadparameter

idstringErforderlich

ID der Liste, zum Beispiel evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.

Rückgabe

Gibt 200 OK mit id, name, status, stats, created_at und updated_at der Liste zurück. stats wird aktualisiert, sobald eine Adresse fertig ist, sodass Sie den Fortschritt einer Liste mit dem Status processing verfolgen können. Die Felder von stats finden Sie unter Liste erstellen.

Gibt 404 zurück, wenn die Liste in Ihrem Workspace nicht existiert.

GET/email-verification-lists/{id}
Terminal
curl -X GET https://api.emailit.com/v2/email-verification-lists/evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json"
JSON
{
  "id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
  "name": "October newsletter import",
  "status": "completed",
  "stats": {
    "total_emails": 1000,
    "processed_emails": 1000,
    "successful_verifications": 996,
    "failed_verifications": 4,
    "pending_emails": 0,
    "results": {
      "safe": 702,
      "role": 41,
      "catch_all": 88,
      "unknown": 37,
      "inbox_full": 3,
      "disabled": 6,
      "disposable": 12,
      "invalid": 107
    }
  },
  "created_at": "2026-10-01T10:30:02.441000+00:00",
  "updated_at": "2026-10-01T10:41:57.020000+00:00"
}

Ergebnisse auflisten

Gibt ein Ergebnis pro Adresse einer Verifizierungsliste zurück, zuletzt aktualisierte zuerst. Ergebnisse erscheinen, sobald die jeweilige Adresse fertig ist; Sie können sie also lesen, bevor die gesamte Liste abgeschlossen ist. Erfordert einen API-Schlüssel mit dem Scope full.

GET/email-verification-lists/:id/results

Pfadparameter

idstringErforderlich

ID der Liste, zum Beispiel evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.

Query-Parameter

pageinteger

Seitennummer, beginnend bei 1. Standardwert 1.

limitinteger

Ergebnisse pro Seite, von 1 bis 100. Standardwert 50.

statusstring

Nur Ergebnisse mit diesem Status: pending, processing, completed, failed oder canceled.

resultstring

Nur Ergebnisse mit diesem Ausgang: safe, role, catch_all, unknown, inbox_full, disabled, disposable oder invalid.

matchstring

all (Standardwert) verlangt, dass alle Filter zutreffen. or trifft zu, wenn ein beliebiger Filter passt. Siehe Filtern und Sortieren.

orderstring

Sortierschlüssel für diese Liste. Siehe die Sortierschlüssel unten.

directionstring

asc oder desc.

Filter und Sortierung

Listenfilter sind Query-Parameter der Form key.condition=value auf einer einzigen Ebene. match, order, direction und die Bedingungen pro Typ finden Sie unter Filtern und Sortieren.

Filterschlüssel

SchlüsselTypBedingungenHinweise
emailstringexact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty
statusstringexact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty
resultstringexact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty
riskstringexact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty
created_atdateexact, before, after, empty, not_empty

Sortierschlüssel

Übergeben Sie in order einen dieser Schlüssel und in direction den Wert asc oder desc: email, status, result, risk, created_at

Rückgabe

Gibt 200 OK mit den Ergebnissen in data zurück, dazu next_page_url und previous_page_url (null am jeweiligen Ende). Jedes Ergebnis ist ein Objekt email_verification mit denselben Feldern, die Adresse verifizieren zurückgibt: id (evr_…), email, status, result, score, risk, mode, checks, address, did_you_mean, mx_records und Zeitstempel. Eine Adresse, die noch pending oder processing ist, hat noch kein endgültiges Ergebnis. Eine Adresse, deren Prüfung ein Fehler abgebrochen hat, hat den Status failed und das Ergebnis error; solche Adressen finden Sie mit status=failed.

Gibt 404 zurück, wenn die Liste in Ihrem Workspace nicht existiert.

GET/email-verification-lists/{id}/results
Terminal
curl -X GET "https://api.emailit.com/v2/email-verification-lists/evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a/results?page=1&limit=10" \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json"
JSON
{
  "data": [
    {
      "id": "evr_2xLeA1Pn6Rw3Ks8Vb0Ht5Mq2Fd9c",
      "object": "email_verification",
      "email": "ada@example.com",
      "status": "completed",
      "score": 100,
      "risk": "low",
      "result": "safe",
      "mode": "full",
      "checks": {
        "valid_syntax": true,
        "disposable": false,
        "role_account": false,
        "inbox_full": false,
        "deliverable": true,
        "disabled": false,
        "catch_all": false,
        "free_email": false,
        "smtp_connect": true,
        "has_mx_records": true,
        "domain_age": 10957,
        "gibberish": false
      },
      "address": {
        "mailbox": "ada",
        "domain": "example.com",
        "suffix": null,
        "root": "ada@example.com"
      },
      "did_you_mean": null,
      "mx_records": [
        { "priority": 10, "exchange": "mx1.example.com" }
      ],
      "created_at": "2026-10-01T10:30:02.441000+00:00",
      "updated_at": "2026-10-01T10:30:09.876000+00:00"
    },
    {
      "id": "evr_2xLeA2Qm7Sx4Lt9Wc1Ju6Nr3Ge0d",
      "object": "email_verification",
      "email": "grace@example.com",
      "status": "completed",
      "score": 0,
      "risk": "high",
      "result": "invalid",
      "mode": "full",
      "checks": {
        "valid_syntax": true,
        "disposable": false,
        "role_account": false,
        "inbox_full": false,
        "deliverable": false,
        "disabled": false,
        "catch_all": false,
        "free_email": false,
        "smtp_connect": true,
        "has_mx_records": true,
        "domain_age": 10957,
        "gibberish": false
      },
      "address": {
        "mailbox": "grace",
        "domain": "example.com",
        "suffix": null,
        "root": "grace@example.com"
      },
      "did_you_mean": null,
      "mx_records": [
        { "priority": 10, "exchange": "mx1.example.com" }
      ],
      "created_at": "2026-10-01T10:30:02.441000+00:00",
      "updated_at": "2026-10-01T10:30:08.112000+00:00"
    }
  ],
  "next_page_url": "/v2/email-verification-lists/evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a/results?page=2&limit=50",
  "previous_page_url": null
}

Ergebnisse exportieren

Lädt die Ergebnisse einer Verifizierungsliste als XLSX-Tabelle herunter. Die Liste muss zuerst den Status completed haben. Erfordert einen API-Schlüssel mit dem Scope full.

GET/email-verification-lists/:id/export

Pfadparameter

idstringErforderlich

ID der Liste, zum Beispiel evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.

Rückgabe

Gibt 200 OK mit der Datei als Antwort-Body, Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet und einem Header Content-Disposition: attachment zurück. Die Datei ist nach der ID der Liste benannt, zum Beispiel evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.xlsx.

Status Wann
400 Die Liste hat noch nicht den Status completed.
404 Die Liste existiert nicht in Ihrem Workspace oder hat keine Ergebnisse zum Exportieren.
GET/email-verification-lists/{id}/export
Terminal
curl -X GET "https://api.emailit.com/v2/email-verification-lists/evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a/export" \
  -H "Authorization: Bearer your_api_key" \
  -o verification_results.xlsx
HTTP
HTTP/1.1 200 OK
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Content-Disposition: attachment; filename="evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.xlsx"

<binary XLSX data>

War diese Seite hilfreich?

Danke für Ihr Feedback.

Danke, wir lesen jede Nachricht.