Create Batch - Bounce Detector

curl -X POST "https://api.bouncedetector.com/api/v1/verify/batch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emails": ["user1@example.com", "user2@example.com", "user3@example.com"]}'

{
  "id": "507f1f77bcf86cd799439011",
  "status": "pending",
  "totalCount": 3,
  "processedCount": 0,
  "message": "Batch job created. Use GET /api/v1/batches/:id to check status."
}

POST

api

verify

batch

curl -X POST "https://api.bouncedetector.com/api/v1/verify/batch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emails": ["user1@example.com", "user2@example.com", "user3@example.com"]}'

{
  "id": "507f1f77bcf86cd799439011",
  "status": "pending",
  "totalCount": 3,
  "processedCount": 0,
  "message": "Batch job created. Use GET /api/v1/batches/:id to check status."
}

Submit up to 1000 emails for batch verification. Returns a batch ID to poll for results via Get Batch Results.

Request

string[]

required

Array of email addresses (1–1000 items)

Response

string

Batch ID (use for GET /api/v1/batches/:id)

string

pending, processing, completed, failed, or cancelled

number

Total emails in batch

number

Emails processed so far

string

Hint for next steps

curl -X POST "https://api.bouncedetector.com/api/v1/verify/batch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emails": ["user1@example.com", "user2@example.com", "user3@example.com"]}'

{
  "id": "507f1f77bcf86cd799439011",
  "status": "pending",
  "totalCount": 3,
  "processedCount": 0,
  "message": "Batch job created. Use GET /api/v1/batches/:id to check status."
}

Authorizations

Authorization

string

header

required

Your API key (e.g. bdt_abc123...). Obtain from the dashboard.

Body

application/json

emails

string<email>[]

required

Required array length: 1 - 1000 elements

Example:

["a@test.com", "b@test.com", "c@test.com"]

Response

Batch job created

string

Batch ID (use for GET /batches/:id)

status

enum<string>

Available options:

pending,

processing,

completed,

failed,

cancelled

totalCount

integer

processedCount

integer

default:0

message

string

Last modified on March 9, 2026

List Verifications List Batches

​Request

​Response

Authorizations

Body

Response

Request

Response