Skip to main content
POST
/
api
/
v1
/
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

​
emails
string[]
required
Array of email addresses (1–1000 items)

​
Response

​
id
string
Batch ID (use for GET /api/v1/batches/:id)
​
status
string
pending, processing, completed, failed, or cancelled
​
totalCount
number
Total emails in batch
​
processedCount
number
Emails processed so far
​
message
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

​
id
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