Batch verification

Verify up to 50 addresses in one synchronous call and get every result back immediately.

Request#

POST/v1/verify/batch1 credit per address
FieldTypeDescription
emailsstring[]1 to 50 addresses. Order is preserved in the response.

Use this for signup forms with several fields, CRM syncs, and small imports where you want answers in the same request. For larger sets use bulk verification. Private keys only.

Example
curl https://app.veridock.io/v1/verify/batch \
  -H "Authorization: Bearer vd_live_…" \
  -H "Content-Type: application/json" \
  -d '{"emails":["a@example.com","b+promo@gmail.com"]}'

Response#

200 OK
{
  "count": 2,
  "credits_used": 2,
  "credits_remaining": 247,
  "request_id": "req_…",
  "results": [
    { "email": "a@example.com", "status": "valid", "score": 9, "…": "standard verification object" },
    { "email": "bad", "error": { "code": "verification_failed", "message": "…" } }
  ]
}

Each entry in results is the standard verification object, or an error object for an address that could not be checked. Errored entries are never charged.

Credits and retries#

  • Credits are checked before anything runs. If the balance is below the number of addresses you get 402 insufficient_credits and nothing is charged.
  • Send an Idempotency-Key to make the whole batch safe to retry: each address is stored under that key plus its position, so a replay returns the same results for free.
  • Requests are limited to 50 addresses and 32 KB.

Related