Verifizierungslisten

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

Basis-URLhttps://api.emailit.com/v2Authentifizierung Fehler Rate Limits

POST/email-verification-lists
GET/email-verification-lists
GET/email-verification-lists/{id}
GET/email-verification-lists/{id}/results
GET/email-verification-lists/{id}/export

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 behält seine Anfangswerte, bis alle Adressen fertig sind; dann wechselt die Liste mit ihren endgültigen Zahlen 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.updated fü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, erfolgreich oder nicht.
`successful_verifications`	Erfolgreich verifizierte Adressen.
`failed_verifications`	Adressen, deren Verifizierung mit einem Fehler fehlgeschlagen ist.
`pending_emails`	Noch nicht verarbeitete Adressen.

POST/email-verification-lists

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const list = await emailit.emailVerificationLists.create({ name: 'October newsletter import', emails: ['ada@example.com', 'grace@example.com'] });

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

vlist = client.email_verification_lists.create({"name": "October newsletter import", "emails": ["ada@example.com", "grace@example.com"]})

PHP

$emailit = Emailit::client('your_api_key');

$list = $emailit->emailVerificationLists()->create(['name' => 'October newsletter import', 'emails' => ['ada@example.com', 'grace@example.com']]);

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

list = client.email_verification_lists.create(name: "October newsletter import", emails: ["ada@example.com", "grace@example.com"])

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

list, err := client.EmailVerificationLists.Create(&emailit.CreateEmailVerificationListRequest{Name: "October newsletter import", Emails: []string{"ada@example.com", "grace@example.com"}})

Rust

use emailit::Emailit;
let emailit = Emailit::new("your_api_key");

let list = emailit.email_verification_lists.create(emailit::types::CreateEmailVerificationListParams::new("October newsletter import", vec!["ada@example.com".into(), "grace@example.com".into()])).await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject list = emailit.emailVerificationLists().create(EmailVerificationListCreateParams.builder().setName("October newsletter import").setEmails(Arrays.asList("ada@example.com", "grace@example.com")).build());

using Emailit;

var emailit = new EmailitClient("your_api_key");

var list = emailit.EmailVerificationLists.Create(new EmailVerificationListCreateOptions { Name = "October newsletter import", Emails = new[] { "ada@example.com", "grace@example.com" } });

PHP

use Emailit\Laravel\Facades\Emailit;

$list = Emailit::emailVerificationLists()->create(['name' => 'October newsletter import', 'emails' => ['ada@example.com', 'grace@example.com']]);

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
  },
  "created_at": "2026-10-01T10:30:02.441000+00:00"
}

JSON

{
  "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.

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üssel	Typ	Bedingungen
`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.

GET/email-verification-lists

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const lists = await emailit.emailVerificationLists.list();

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

vlists = client.email_verification_lists.list()

PHP

$emailit = Emailit::client('your_api_key');

$lists = $emailit->emailVerificationLists()->list();

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

lists = client.email_verification_lists.list

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

lists, err := client.EmailVerificationLists.List(nil)

Rust

use emailit::Emailit;
let emailit = Emailit::new("your_api_key");

let lists = emailit.email_verification_lists.list(None).await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject lists = emailit.emailVerificationLists().list();

using Emailit;

var emailit = new EmailitClient("your_api_key");

var lists = emailit.EmailVerificationLists.List();

PHP

use Emailit\Laravel\Facades\Emailit;

$lists = Emailit::emailVerificationLists()->list();

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

JSON

{
  "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.

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. Solange eine Liste den Status processing hat, zeigt stats die Anfangswerte; die endgültigen Zahlen werden beim Abschluss geschrieben. 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}

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const list = await emailit.emailVerificationLists.get('evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a');

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

vlist = client.email_verification_lists.get("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a")

PHP

$emailit = Emailit::client('your_api_key');

$list = $emailit->emailVerificationLists()->get('evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a');

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

list = client.email_verification_lists.get("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a")

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

list, err := client.EmailVerificationLists.Get("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a")

Rust

use emailit::Emailit;
let emailit = Emailit::new("your_api_key");

let list = emailit.email_verification_lists.get("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a").await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject list = emailit.emailVerificationLists().get("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a");

using Emailit;

var emailit = new EmailitClient("your_api_key");

var list = emailit.EmailVerificationLists.Get("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a");

PHP

use Emailit\Laravel\Facades\Emailit;

$list = Emailit::emailVerificationLists()->get('evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a');

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
  },
  "created_at": "2026-10-01T10:30:02.441000+00:00",
  "updated_at": "2026-10-01T10:41:57.020000+00:00"
}

JSON

{
  "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.

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, invalid, disposable, disabled, inbox_full oder unknown. Um Rollenadressen zu finden, verwenden Sie result.exact=role.

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üssel	Typ	Bedingungen
`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 enthält id (ev_…), email, status, result, score, risk, mx_records, error_message (gesetzt, wenn die Verifizierung fehlgeschlagen ist) und die Zeitstempel der Adresse. result, score und risk haben dieselbe Bedeutung wie unter Adresse verifizieren. Alle Einzelprüfungen erhalten Sie, wenn Sie die Ergebnisse exportieren.

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

GET/email-verification-lists/{id}/results

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const results = await emailit.emailVerificationLists.results('evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a', { page: 1, limit: 10 });

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

results = client.email_verification_lists.results("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a", {"page": 1, "limit": 10})

PHP

$emailit = Emailit::client('your_api_key');

$results = $emailit->emailVerificationLists()->results('evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a', ['page' => 1, 'limit' => 10]);

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

results = client.email_verification_lists.results("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a", page: 1, limit: 10)

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

results, err := client.EmailVerificationLists.Results("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a", nil)

Rust

use emailit::Emailit;
let emailit = Emailit::new("your_api_key");

let results = emailit.email_verification_lists.results("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a", None).await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject results = emailit.emailVerificationLists().results("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a");

using Emailit;

var emailit = new EmailitClient("your_api_key");

var results = emailit.EmailVerificationLists.Results("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a");

PHP

use Emailit\Laravel\Facades\Emailit;

$results = Emailit::emailVerificationLists()->results('evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a', ['page' => 1, 'limit' => 10]);

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": "ev_2xLeA1Pn6Rw3Ks8Vb0Ht5Mq2Fd9c",
      "email": "ada@example.com",
      "status": "completed",
      "result": "safe",
      "score": 100,
      "risk": "low",
      "mx_records": [
        { "priority": 10, "exchange": "mx1.example.com" }
      ],
      "error_message": null,
      "created_at": "2026-10-01T10:30:02.441000+00:00",
      "updated_at": "2026-10-01T10:30:09.876000+00:00"
    },
    {
      "id": "ev_2xLeA2Qm7Sx4Lt9Wc1Ju6Nr3Ge0d",
      "email": "info@acme-typo.example",
      "status": "completed",
      "result": "invalid",
      "score": 25,
      "risk": "high",
      "mx_records": [],
      "error_message": null,
      "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
}

JSON

{
  "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.

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

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const exported = await emailit.emailVerificationLists.export('evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a');

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

exported = client.email_verification_lists.export("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a")

PHP

$emailit = Emailit::client('your_api_key');

$exported = $emailit->emailVerificationLists()->export('evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a');

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

exported = client.email_verification_lists.export("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a")

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

exported, err := client.EmailVerificationLists.Export("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a")

Rust

use emailit::Emailit;
let emailit = Emailit::new("your_api_key");

let exported = emailit.email_verification_lists.export("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a").await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

ApiResponse exported = emailit.emailVerificationLists().export("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a");

using Emailit;

var emailit = new EmailitClient("your_api_key");

var exported = emailit.EmailVerificationLists.Export("evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a");

PHP

use Emailit\Laravel\Facades\Emailit;

$exported = Emailit::emailVerificationLists()->export('evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a');

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>

JSON

{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "Cannot export incomplete list. List must be completed first."
}

JSON

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Email verification list not found"
}