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
| Field | Type | Description |
|---|---|---|
| emails | string[] | 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_creditsand nothing is charged. - Send an
Idempotency-Keyto 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