Docs/Massen-Verifizierung

Massen-Verifizierung

Lade eine CSV mit E-Mail-Adressen hoch und erhalte Ergebnisse für deine gesamte Liste.

Markdown ansehen OpenAPI JSON

Übersicht

Mit der Massenverifizierung prüfst du Tausende E-Mail-Adressen in einem einzigen Job. Lade eine CSV-Datei über das Dashboard oder die API hoch und lade die Ergebnisse herunter, sobald der Job fertig ist.

ℹ️
Die Massenverifizierung ist über das Dashboard und die API verfügbar. Lade CSV-Dateien hoch mit POST /api/bulk, frag den Status ab mit GET /api/bulk/{job_id} und lade die Ergebnisse dann herunter über /api/bulk/{job_id}/download.

Upload per API

Sende einen Multipart-CSV-Upload mit deinem API-Schlüssel. Optional kannst du email_column mitgeben, wenn das E-Mail-Feld nicht so heißt: email.

bash
curl -X POST https://verimails.com/api/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@leads.csv" \
  -F "name=May outreach" \
  -F "email_column=Email Address"

Upload über das Dashboard

  1. Melde dich an bei verimails.com/dashboard
  2. Klicke auf Bulk Verify in der Seitenleiste
  3. Lade deine CSV-Datei hoch
  4. Warte, bis der Job abgeschlossen ist (sichtbar in deiner Job-Liste)
  5. Lade die Ergebnis-CSV herunter

CSV-Format

Deine CSV braucht eine Spalte mit E-Mail-Adressen. VeriMails erkennt gängige Spaltenüberschriften automatisch, etwa email, Email Address, work_email und business_email. Einspaltige CSVs ohne Kopfzeile werden ebenfalls unterstützt, eine klare E-Mail-Überschrift ist aber trotzdem am besten:

csv
email
john@example.com
jane@company.com
info@business.io
sales@corp.net

Zusätzliche Spalten bleiben in der Ausgabe erhalten und beeinflussen die Verarbeitung nicht.

Unterstützte Formate

Ausgabeformat

Die vollständige Ergebnisdatei behält die ursprünglichen CSV-Spalten und ergänzt eine klare Spalte zur Versandfähigkeit:

Hinzugefügte SpalteBeschreibung
Safe to SendYes wenn der verifizierte Status gültig ist; No bei ungültigen, Catch-all-, Wegwerf-, unbekannten oder riskanten Ergebnissen.

Job-Status prüfen

Im Dashboard zeigt deine Job-Liste den Fortschritt in Echtzeit. Per API fragst du regelmäßig ab: GET /api/bulk/{job_id} bis der Job-Status lautet: completed oder failed.

Webhook-Benachrichtigungen

Webhook-Support für abgeschlossene Bulk-Jobs kommt bald. Siehe Webhooks →

💡
Tipp: Für den Listenaufbau in Echtzeit nutze die API für Einzelverifizierung und verifiziere Adressen direkt beim Sammeln. Die Massenverifizierung eignet sich am besten zum Bereinigen bestehender Listen.