Skip to content
VerifyEmailAPI

Poll progress

GET /v1/bulk-verifications/{jobId}

Response

Section titled “Response”
{
  "id": "137eb443-2c6e-4a0f-9b7d-5e1f8a3c2d41",
  "name": "june-newsletter",
  "status": "verifying",
  "received": 2,
  "unique": 2,
  "duplicate": 0,
  "queued": 1,
  "processing": 0,
  "completed": 1,
  "failed": 0,
  "verdicts": {
    "deliverable": 1,
    "undeliverable": 0,
    "risky": 0,
    "unknown": 0
  }
}
Field Description
status accepting_input → preparing → verifying → completed. failed and cancelled are the other terminal states.
received Rows you uploaded.
unique / duplicate How many of those were distinct addresses after normalization. A duplicate is verified once and shares its result.
queued / processing / completed / failed Where each row is right now. A failed row could not be verified at all — it was not parseable as an address, or a fault on our side stopped the check.
verdicts A running tally of finished rows by verdict.

Poll every few seconds until status is completed. Rows finish individually, so you can start exporting before the whole job is done.

See also

Section titled “See also”