API reference · v1

Bulk email verification API

Send an array of addresses or upload a CSV. Jobs run asynchronously, you can poll or receive a webhook, and results are available as CSV, JSON, or newline-delimited JSON filtered by status.

curl -X POST https://app.veridock.io/v1/bulk \
  -H "Authorization: Bearer vd_live_••••••••••••" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "october-newsletter",
    "emails": ["a@acme.com", "b@acme.com", "c@example.org"],
    "webhook_url": "https://example.com/hooks/veridock"
  }'

# → { "id": "job_8f2k1", "status": "queued", "total": 3 }

Job status	Meaning
queued	Accepted and waiting for a worker.
processing	Running. processed increments as results come in.
completed	All rows done. download_url is valid for 7 days.
failed	Could not run. The error field explains why. Nothing is billed.