Skip to main content
POST
Create a batch verification request.
Use a stable Idempotency-Key for an identical submission. Creation returns 202; a replay returns 200 with the same request ID. Capture request.id, then pass it to the status and results routes. A batch accepts up to 10,000 addresses.

Authorizations

X-Api-Key
string
header
required

Canonical authentication. Send a Bounceless key in blc.… format.

Headers

Idempotency-Key
string
required
Minimum string length: 1

Body

application/json

Provide exactly one input source. Use emails for an inline batch or listId for a ready list already stored in the account.

emails
string<email>[]
required
Required array length: 1 - 10000 elements
Maximum string length: 320
listId
string<uuid>

Response

Idempotent replay

request
object
required
counters
object
required
requestId
string
required
replayed
boolean