Menü

Dokumentation

Email Verifier API

Prüfe E-Mail-Adressen, bevor du sie anschreibst. So sinken Bounces und deine Listen bleiben sauber.

E-Mail-Verifikation
https://api.flowdata.one/v1/email-verification/{email}

OpenAPI-Datei dieses Bereichs

Schnellstart

FlowData-Schlüssel
Diese API gehört zu FlowData und nutzt eigene Schlüssel (fd_...), die du im Dashboard unter API-Schlüssel anlegst. FlowSuite-Schlüssel (pk_..., at_...) funktionieren weiterhin, wir empfehlen aber einen FlowData-Schlüssel.
Schlüssel nur im Header
Sende den Schlüssel ausschließlich im Header Authorization: Bearer fd_..., nie in der Adresse.
Externe Prüfdienste
Reicht die eigene Prüfung nicht aus, geht die Adresse an angebundene Prüfdienste (Emailable, Hunter, Leadrocks).
Sicherheitshinweis
Verwende API-Schlüssel niemals in Frontend-Code. Leite Anfragen in Produktionsumgebungen über dein eigenes Backend.

Überblick

Die Email Verifier API prüft eine E-Mail-Adresse in mehreren Stufen und hört auf, sobald eine Stufe ein eindeutiges Ergebnis liefert:

  1. Syntax nach RFC 5321/5322, inklusive internationalisierter Domains
  2. Gespeichertes Ergebnis für dieselbe Adresse, wenn es noch gültig ist
  3. Mailserver der Domain (MX-Einträge, Null-MX nach RFC 7505, A/AAAA-Rückfall)
  4. Wegwerf-Domains und bekannte Catch-All-Domains
  5. Prüfung des Postfachs über angebundene Prüfdienste

Zusätzlich wird markiert, ob es sich um eine Rollenadresse wie info@ oder buchhaltung@ handelt.

API-Endpunkte

GET
/v1/email-verification/{email}

E-Mail-Adresse verifizieren

Prüft eine E-Mail-Adresse. result ist safe (zustellbar), risky (zustellbar, aber unsicher), invalid (nicht zustellbar) oder unknown (nicht feststellbar, wird nicht berechnet). reason nennt den Grund: accepted, catch_all, role_account, disposable, invalid_syntax, invalid_domain, null_mx, rejected, low_quality, unverifiable, processing_objected (die betroffene Person hat der Verarbeitung ihrer Daten widersprochen) oder dns_unavailable. checks enthält die einzelnen Prüfungen (Syntax, Mailserver, Mailanbieter, Wegwerf-Domain, Rollenadresse, Catch-All). Die bisherigen Felder bleiben: status ist valid, wenn an die Adresse gesendet werden kann, sonst risky, invalid, disposable oder unknown. source zeigt, woher das Ergebnis stammt: DB (gespeichertes Ergebnis), NA (eigene Prüfung) oder ein Prüfdienst (LR, HU, EA). Eine syntaktisch ungültige Adresse beantwortet die API mit HTTP 400.

Bearer fd_… 9,00 EUR je 1.000 erfolgreiche Anfragen

Pfad-Parameter

Name Typ Beschreibung
email string
Pflicht
E-Mail-Adresse zur Verifikation
curl -X GET "https://api.flowdata.one/v1/email-verification/max@example.com" \
  -H "Authorization: Bearer fd_DEIN_SCHLUESSEL" \
  -H "Accept: application/json"
use Illuminate\Support\Facades\Http;

$response = Http::withToken('fd_DEIN_SCHLUESSEL')
    ->get('https://api.flowdata.one/v1/email-verification/max@example.com');

$data = $response->json();
const response = await fetch('https://api.flowdata.one/v1/email-verification/max@example.com', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer fd_DEIN_SCHLUESSEL',
    'Accept': 'application/json',
  },
});

const data = await response.json();
import requests

headers = {
    'Authorization': 'Bearer fd_DEIN_SCHLUESSEL',
    'Accept': 'application/json',
}

response = requests.get(
    'https://api.flowdata.one/v1/email-verification/max@example.com',
    headers=headers,
)

data = response.json()
{
    "email_address": "user@example.com",
    "status": "valid",
    "source": "NA",
    "result": "risky",
    "reason": "catch_all",
    "checks": {
        "syntax": true,
        "mx": "ok",
        "mail_provider": "other",
        "disposable": false,
        "role_account": false,
        "catch_all": true
    }
}

Validierungs-Features

Syntax

  • Prüfung nach RFC 5321/5322
  • Internationalisierte Domains (IDN)
  • Längengrenzen für Adresse, lokalen Teil und Domain

Domain

  • MX-Einträge und Mailanbieter der Domain
  • Null-MX (Domain nimmt keine Mails an)
  • Domains ohne Mailserver
  • Catch-All-Domains, sobald ein Prüfdienst sie erkannt hat

Postfach

  • Prüfung über angebundene Prüfdienste, nur wenn die eigenen Prüfungen nicht entscheiden
  • Gespeicherte Ergebnisse werden je nach Ergebnis 3 bis 90 Tage wiederverwendet

Qualität

  • Wegwerf-Domains (wöchentlich aktualisierte Liste)
  • Rollenadressen wie info@, support@ oder buchhaltung@

Ein Schlüssel reicht für den Anfang.

Leg einen Schlüssel an und ruf die API auf. Client-Info kostet nichts, alles andere rechnest du je erfolgreicher Anfrage ab.

API-Schlüssel anlegen Dokumentation

FlowData richtet sich ausschließlich an Unternehmen und Selbstständige.