Proper Check
Entwickler-Hub · REST API v1

API zur Verifizierung von E-Mail-Adressen

Mailinglisten programmatisch prüfen — weniger Bounces, bessere Zustellbarkeit

Verbinden Sie Anmeldeformulare, CRMs und Landing Pages mit EmailVerifier. Prüfen Sie E-Mail-Adressen per REST API in Echtzeit oder Bulk-Jobs — transparente Abrechnung 1 request = 1 credit.

  • Echtzeit-Verifizierung
  • Bulk bis 50.000 E-Mails
  • 1 Anfrage = 1 Credit
API-Schlüssel generierenKonto erstellenOpenAPI / Redoc

Beispielanfrage

curl -X POST https://propercheck.pl/api/v1/verify \
  -H "Authorization: Bearer ev_live_…" \
  -d '{"email":"user@company.com"}'

API-Wissensbasis

Thema wählen — von Authentifizierung und Credits bis Bulk, Webhooks und Fehlercodes.

APIE-Mail-Verifizierungs-API

POST /verify — eine Adresse, Ergebnis in unter einer Sekunde, Status valid/invalid/risky.

Mehr erfahren
APIBulk E-Mail-Verifizierung

Massenprüfung von CSV-Listen — Job-Warteschlange, Fortschritts-Polling und CSV-Export.

Mehr erfahren
APICredits und Abrechnung

Saldo, API-Nutzung, 1 credit = 1 Verifizierung, HTTP-402-Behandlung.

Mehr erfahren
APIAPI-Schlüssel und Auth

Bearer ev_live_, Token-Panel, sichere Schlüsselspeicherung.

Mehr erfahren
APIWebhooks und Integrationen

verification.completed, HMAC-Signatur, CRM und Marketing-Automation.

Mehr erfahren
APIOpenAPI-Referenz

Vollständige YAML-Spezifikation, Redoc-UI und HTTP-Fehlerkatalog.

Mehr erfahren

Was ist eine E-Mail-Verifizierungs-API?

Eine REST-Schnittstelle zur Validierung von Adressen vor Kampagnenversand.

Eine E-Mail-Verifizierungs-API prüft, ob eine Adresse existiert, ob die Domain Mail annimmt und ob das Postfach disposable oder catch-all ist. Sie senken die Bounce-Rate, schützen die Absenderreputation und verbessern die Zustellung.

Die API läuft über HTTPS unter /api/v1. Authentifizierung mit Bearer-Schlüssel (ev_live_…) oder Dashboard-Session. Jeder erfolgreiche POST /verify kostet einen credit — ohne Abo und ohne versteckte GET-Gebühren.

Wann eine E-Mail-Validator-API nutzen

Typische Integrationsszenarien in B2B-Produkten und Marketing-Stacks.

Anmeldeformulare

E-Mail bei Registrierung in Echtzeit validieren — invalid und disposable vor Listeneintrag ablehnen.

CRM und Lead-Erfassung

Leads von Landing Pages und Webhooks bereinigen — nur zustellbare Adressen ins Pipeline.

Listenhygiene vor Kampagnen

Bulk API vor Newsletter — weniger Bounces, höhere Open Rate und niedrigere ESP-Kosten.

SaaS-Plattformen

E-Mail-Checks ins Produkt einbetten — Credit-basierte Abrechnung vereinfacht Kundenpreise.

API-Credit-Modell

Einfache Preise: eine Verifizierungsanfrage = ein credit.

  • POST /verify berechnet 1 credit pro erfolgreicher Anfrage (HTTP 200) mit ev_live_-Schlüsseln, auch wenn dieselbe Adresse zuvor per API geprüft wurde. Sandbox-Schlüssel (ev_test_) liefern Mock ohne Credit-Abbuchung.
  • GET-Operationen — Saldo, Verlauf, Bulk-Job-Status, CSV-Export — sind kostenlos.
  • Unzureichender Saldo liefert HTTP 402 (insufficient_credits). Engine-Fehler (503) berechnen keinen credit.

Authentifizierung und API-Schlüssel

Sicherer Zugriff über den Authorization-Header.

  1. Im Dashboard anmelden und API tokens (/account/api) öffnen.
  2. Produktionsschlüssel (ev_live_) oder Sandbox (ev_test_) im Panel erstellen — vollständiges Secret nur einmal sichtbar.
  3. Schlüssel als Authorization: Bearer ev_live_… senden — nie in URLs oder Client-Code.
Authorization: Bearer ev_live_YOUR_API_KEY
Content-Type: application/json

Schnellstart — E-Mail-Verifizierungs-API

Zwei Aufrufe: Saldo prüfen und erste Verifizierung.

1. Credit-Saldo prüfen

curl https://propercheck.pl/api/v1/credits \
  -H "Authorization: Bearer ev_live_YOUR_KEY"

2. Eine E-Mail-Adresse verifizieren

curl -X POST https://propercheck.pl/api/v1/verify \
  -H "Authorization: Bearer ev_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"john@company.com"}'

Einzelverifizierung (Echtzeit)

POST /api/v1/verify akzeptiert JSON mit email-Feld. Antwort enthält status, score 0–100, provider (Google, Microsoft, regionale Hosts) und enrichment (MX, catch-all).

POST /api/v1/verify

JSON-Antwortstruktur

Felder nach erfolgreicher Verifizierung.

{
  "verificationId": "ver_abc123",
  "email": "john@company.com",
  "status": "valid",
  "score": 92,
  "provider": "google",
  "enrichment": { "mxRecords": ["aspmx.l.google.com"], "catchAll": false },
  "creditsRemaining": 149
}

E-Mail-Verifizierungsstatus

Klassifikation in API, Dashboard und CSV-Exporten.

valid

valid — Adresse existiert und kann Mail empfangen; sicher zum Versand.

invalid

invalid — Adresse existiert nicht oder Domain ohne Mail; aus Liste entfernen.

risky

risky — geringe Konfidenz (z. B. disposable, role account); Vorsicht in Kampagnen.

catch_all

catch_all — Server akzeptiert alle Adressen der Domain; höheres Bounce-Risiko.

unknown

unknown — uneindeutige SMTP-Antwort; spätere erneute Prüfung erwägen.

REST-Endpoint-Referenz

Vollständige API-v1-Pfadliste mit Credit-Kosten.

MethodePfadCreditsBeschreibung
POST/verify1Echtzeit-Einzel-E-Mail-Verifizierung
GET/verify/:id0Ergebnis per verificationId abrufen
GET/verifications0Verifizierungsverlauf und 30-Tage-Statistik
GET/credits0Aktueller Account-Credit-Saldo
POST/bulkNBulk-Job erstellen (N Credits)
GET/bulk/:id0Bulk-Job-Status und Fortschritt
GET/bulk/:id/export0Ergebnisse als CSV herunterladen
GET/POST/PATCH/DELETE/api-keys0API-Token-Verwaltung (Session)
GET/POST/DELETE/webhooks0Webhook-Konfiguration (Session)
GET/usage0API- und Credit-Nutzungsstatistik

Bulk-E-Mail-Verifizierungs-API

Tausende Adressen in einem Job prüfen — ideal vor großen Kampagnen.

  1. POST /bulk mit emails-Array oder CSV-Text — Credits für N eindeutige Adressen reserviert.
  2. GET /bulk/:id — Status-Polling (queued → processing → completed).
  3. GET /bulk/:id/export — CSV mit Spalten email, status, score, provider.
curl -X POST https://propercheck.pl/api/v1/bulk \
  -H "Authorization: Bearer ev_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emails":["a@b.co","c@d.co"]}'

Webhooks — Ereignis verification.completed

POST an Ihre URL nach Abschluss der Verifizierung. Header X-EV-Signature enthält HMAC-SHA256 des Body — Signatur vor Verarbeitung prüfen.

X-EV-Event: verification.completed
X-EV-Signature: <hmac-sha256 of body>

Rate Limits

Standard 60 Anfragen pro Minute pro API-Schlüssel. Überschreitung liefert HTTP 429 mit rate_limit_exceeded. Limits pro Schlüssel — separate Tokens pro Integration.

Optionaler Header bei POST /verify — sichere Retries ohne doppelte Credit-Abbuchung (24h TTL).

X-Request-Id

Jede API-Antwort enthält X-Request-Id — bei Support-Anfragen zur Integrationsdebugging angeben.

HTTP-Fehlercodes

HTTPCodeBeschreibung
401unauthorizedSession oder API-Schlüssel in der Anfrage fehlt.
401invalid_api_keyUngültiger, abgelaufener oder widerrufener API-Schlüssel.
400invalid_requestUngültiges JSON, email-Feld fehlt oder Adresse malformed.
402insufficient_creditsUnzureichende Credits — aufladen unter /account/credits.
429rate_limit_exceededRate-Limit überschritten — Standard 60 Anfragen/Min pro API-Schlüssel.
503engine_unavailableVerifizierungs-Engine nicht verfügbar — kein credit berechnet.

Integrationsbeispiele

Gleicher Verifizierungs-Flow in gängigen Sprachen.

curl -X POST https://propercheck.pl/api/v1/verify \
  -H "Authorization: Bearer ev_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"john@company.com"}'

FAQ — E-Mail-Verifizierungs-API

Häufige Fragen von Entwicklern und Marketern.

OpenAPI 3.1 und Redoc

Maschinenlesbare Spezifikation für Codegen, Contract Tests und CI-Pipelines.

openapi-v1.yaml herunterladenInteraktive Redoc-Referenz

E-Mails per API verifizieren

Kostenlose Test-Credits bei Registrierung. API-Schlüssel im Dashboard in einer Minute.

Konto erstellenAPI-Token

Schlüssel im Account-Panel generieren.