Verifizierungslisten
Bis zu 10.000 Adressen auf einmal verifizieren und die Ergebnisse exportieren.
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.
/email-verification-listsAnfrage-Body
namestringErforderlichName der Liste, 1 bis 255 Zeichen.
emailsstring[]ErforderlichZu 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:
email_verification_list.created, wenn die Liste erstellt wird.email_verification.updatedfür jede Adresse, sobald sie fertig ist.email_verification_list.updated, wenn die Liste abgeschlossen ist.
| 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. |
{
"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"
}{
"statusCode": 402,
"error": "Payment Required",
"message": "Insufficient credits for email verification list."
}Listen auflisten
Gibt Ihre E-Mail-Verifizierungslisten zurück, neueste zuerst. Erfordert einen API-Schlüssel mit dem Scope full.
/email-verification-listsQuery-Parameter
pageintegerSeitennummer, beginnend bei 1. Standardwert 1.
limitintegerListen pro Seite, von 1 bis 100. Standardwert 10.
statusstringNur Listen mit diesem Status: pending, processing, completed, failed oder canceled.
searchstringAbgleich mit dem Namen der Liste, ohne Beachtung der Groß-/Kleinschreibung.
matchstringall (Standardwert) verlangt, dass alle Filter zutreffen. or trifft zu, wenn ein beliebiger Filter passt. Siehe Filtern und Sortieren.
orderstringSortierschlüssel für diese Liste. Siehe die Sortierschlüssel unten.
directionstringasc 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üssel | Typ | Bedingungen | Hinweise |
|---|---|---|---|
name | string | exact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty | |
status | string | exact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty | |
created_at | date | exact, 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.
{
"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
}{
"statusCode": 401,
"error": "Unauthorized",
"message": "Invalid API key"
}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.
/email-verification-lists/:idPfadparameter
idstringErforderlichID 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.
{
"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"
}{
"statusCode": 404,
"error": "Not Found",
"message": "Email verification list not found"
}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.
/email-verification-lists/:id/resultsPfadparameter
idstringErforderlichID der Liste, zum Beispiel evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.
Query-Parameter
pageintegerSeitennummer, beginnend bei 1. Standardwert 1.
limitintegerErgebnisse pro Seite, von 1 bis 100. Standardwert 50.
statusstringNur Ergebnisse mit diesem Status: pending, processing, completed, failed oder canceled.
resultstringNur Ergebnisse mit diesem Ausgang: safe, role, catch_all, unknown, inbox_full, disabled, disposable oder invalid.
matchstringall (Standardwert) verlangt, dass alle Filter zutreffen. or trifft zu, wenn ein beliebiger Filter passt. Siehe Filtern und Sortieren.
orderstringSortierschlüssel für diese Liste. Siehe die Sortierschlüssel unten.
directionstringasc 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üssel | Typ | Bedingungen | Hinweise |
|---|---|---|---|
email | string | exact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty | |
status | string | exact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty | |
result | string | exact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty | |
risk | string | exact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty | |
created_at | date | exact, 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.
{
"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
}{
"statusCode": 404,
"error": "Not Found",
"message": "Email verification list not found"
}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.
/email-verification-lists/:id/exportPfadparameter
idstringErforderlichID 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. |
HTTP/1.1 200 OK
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Content-Disposition: attachment; filename="evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a.xlsx"
<binary XLSX data>{
"statusCode": 400,
"error": "Bad Request",
"message": "Cannot export incomplete list. List must be completed first."
}{
"statusCode": 404,
"error": "Not Found",
"message": "Email verification list not found"
}