E-Mail-Verifizierung

Eine einzelne Adresse in Echtzeit verifizieren.

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

Adresse verifizieren

Verifiziert eine E-Mail-Adresse und gibt das Ergebnis in der Antwort zurück. Jede Verifizierung kostet 5 Credits, die vor der Prüfung berechnet werden. Um viele Adressen auf einmal zu verifizieren, erstellen Sie eine Verifizierungsliste. Erfordert einen API-Schlüssel mit dem Scope full.

POST/email-verifications

Anfrage-Body

emailstringErforderlich

Zu verifizierende Adresse. Ein Wert, der keine gültige Adresse ist, gibt trotzdem 200 zurück, mit result: "invalid" und einem Score von 0, und wird berechnet.

modestring

fast (Standard) prüft Syntax, Wegwerf- und Rollenadressen, Freemail-Anbieter, sinnlose Zeichenfolgen, MX-Einträge und das Alter der Domain. full verbindet sich zusätzlich mit dem Mailserver des Empfängers, um zu prüfen, ob das Postfach existiert, deaktiviert oder voll ist und ob die Domain alle Adressen annimmt. Im Modus fast sind die Postfachprüfungen null.

Rückgabe

Gibt 200 OK mit einem Objekt email_verification zurück. Emailit sendet außerdem das Webhook-Event email_verification.created.

Status	Wann
`400`	`email` fehlt oder `mode` ist nicht `fast` oder `full` (Standard-Validierungsfehler).
`402`	Im Workspace sind keine 5 Credits mehr übrig. Der Body ist `{"error": {"message": "…", "code": 402}}`.

Ergebnis

`result`	Bedeutung
`safe`	Hat alle Prüfungen bestanden und einen Score von 70 oder mehr erreicht.
`invalid`	Die Syntax ist ungültig oder die Domain hat keine MX-Einträge und kann daher keine E-Mails empfangen.
`disposable`	Die Domain gehört zu einem Wegwerf-E-Mail-Dienst.
`disabled`	Das Postfach existiert, ist aber deaktiviert. Nur im Modus `full`.
`inbox_full`	Das Postfach ist voll. Nur im Modus `full`.
`role`	Eine Rollenadresse wie `info@` oder `support@`.
`unknown`	Keine Prüfung ist fehlgeschlagen, aber der Score liegt unter 70.

Score und Risiko

score reicht von 0 bis 100. risk ist high, wenn die Syntax ungültig ist, die Domain keine MX-Einträge hat, die Adresse eine Wegwerf-Adresse ist oder das Postfach deaktiviert ist. Andernfalls richtet sich der Wert nach dem Score: low ab 80, medium ab 50 und high unter 50.

Felder

statusstring

completed bei Einzelverifizierungen.

checksobject

Einzelne Prüfungen: valid_syntax, disposable, role_account, free_email, gibberish und has_mx_records (Booleans), domain_age (Alter der Domain in Tagen oder null, wenn unbekannt) sowie die Prüfungen des Modus full: smtp_connect, deliverable, disabled, inbox_full und catch_all (null im Modus fast).

addressobject

Die Adresse, aufgeteilt in mailbox, domain, suffix (der Teil nach + oder null) und root (die Adresse ohne Suffix).

did_you_meanstring | null

Korrekturvorschlag für einen wahrscheinlichen Tippfehler, zum Beispiel ada@gmail.com für ada@gmial.com.

mx_recordsobject[]

Die MX-Einträge der Domain, jeweils mit priority und exchange.

POST/email-verifications

JavaScript

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

const result = await emailit.emailVerifications.verify({ email: 'ada@example.com' });

Python

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

result = client.email_verifications.verify({"email": "ada@example.com"})

PHP

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

$result = $emailit->emailVerifications()->verify(['email' => 'ada@example.com']);

Ruby

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

result = client.email_verifications.verify(email: "ada@example.com")

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

result, err := client.EmailVerifications.Verify(&emailit.VerifyEmailRequest{Email: "ada@example.com"})

Rust

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

let result = emailit.email_verifications.verify(emailit::types::VerifyEmailParams::new("ada@example.com")).await?;

Java

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

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject result = emailit.emailVerifications().create(EmailVerificationCreateParams.builder().setEmail("ada@example.com").build());

using Emailit;

var emailit = new EmailitClient("your_api_key");

var result = emailit.EmailVerifications.Verify(new EmailVerificationVerifyOptions { Email = "ada@example.com" });

PHP

use Emailit\Laravel\Facades\Emailit;

$result = Emailit::emailVerifications()->verify(['email' => 'ada@example.com']);

Terminal

curl -X POST https://api.emailit.com/v2/email-verifications \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "ada@example.com"}'

JSON

{
  "id": "ev_2xLd4Wq8Bn1Ys6Pk3Rm9Tc0Fh5a",
  "object": "email_verification",
  "email": "ada@example.com",
  "status": "completed",
  "score": 100,
  "risk": "low",
  "result": "safe",
  "mode": "fast",
  "checks": {
    "valid_syntax": true,
    "disposable": false,
    "role_account": false,
    "inbox_full": null,
    "deliverable": null,
    "disabled": null,
    "catch_all": null,
    "free_email": false,
    "smtp_connect": null,
    "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:20:31.118000+00:00",
  "updated_at": "2026-10-01T10:20:31.118000+00:00"
}

JSON

{
  "error": {
    "message": "Workspace has insufficient email credits for email verification. Each verification requires 5 credits.",
    "code": 402
  }
}