Docs/Bulkverificatie

Bulkverificatie

Upload een CSV met e-mailadressen en krijg resultaten voor je hele lijst.

Markdown bekijken OpenAPI JSON

Overzicht

Met bulkverificatie verifieer je duizenden e-mailadressen in één job. Upload een CSV-bestand via het dashboard of de API en download de resultaten zodra de job klaar is.

ℹ️
Bulkverificatie is beschikbaar via het dashboard en de API. Upload CSV-bestanden met POST /api/bulk, poll GET /api/bulk/{job_id}en download daarna de resultaten via /api/bulk/{job_id}/download.

Uploaden via de API

Stuur een multipart-CSV-upload mee met je API-sleutel. Optioneel kun je email_column meegeven als het e-mailveld niet de naam heeft 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"

Uploaden via het dashboard

  1. Log in op verimails.com/dashboard
  2. Klik op Bulk Verify in de zijbalk
  3. Upload je CSV-bestand
  4. Wacht tot de job klaar is (zichtbaar in je joblijst)
  5. Download de resultaten-CSV

CSV-formaat

Je CSV moet een kolom met e-mailadressen hebben. VeriMails herkent automatisch gangbare headers zoals email, Email Address, work_email, en business_email. CSV's met één kolom zonder header worden ook ondersteund, maar een duidelijke e-mailheader blijft het beste:

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

Extra kolommen blijven behouden in de output en hebben geen invloed op de verwerking.

Ondersteunde formaten

Outputformaat

Het volledige resultaatbestand behoudt de oorspronkelijke CSV-kolommen en voegt een duidelijke kolom voor verzendbaarheid toe:

Toegevoegde kolomBeschrijving
Safe to SendYes als de geverifieerde status geldig is; No bij ongeldige, catch-all-, wegwerp-, onbekende of risicovolle resultaten.

Jobstatus controleren

In het dashboard toont je joblijst de voortgang in realtime. Via de API poll je GET /api/bulk/{job_id} totdat de jobstatus gelijk is aan completed of failed.

Webhookmeldingen

Webhook-ondersteuning voor afgeronde bulkjobs komt binnenkort. Zie Webhooks →

💡
Tip: Voor het realtime opbouwen van lijsten gebruik je de API voor losse verificatie om adressen te verifiëren terwijl je ze verzamelt. Bulkverificatie is het beste voor het opschonen van bestaande lijsten.