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."
}
Batch
Create Batch
Submit emails for batch verification.
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
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 cancellednumber
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
Your API key (e.g. bdt_abc123...). Obtain from the dashboard.
Body
application/json
Required array length:
1 - 1000 elementsExample:
["a@test.com", "b@test.com", "c@test.com"]
Last modified on March 9, 2026