curl -X GET "https://api.bouncedetector.com/api/v1/batches/507f1f77bcf86cd799439011" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"batch": {
"_id": "507f1f77bcf86cd799439011",
"status": "completed",
"totalCount": 2,
"processedCount": 2,
"createdAt": "2025-03-09T14:30:00.000Z"
},
"emails": [
{
"id": "507f1f77bcf86cd799439013",
"email": "user@example.com",
"status": "verified",
"result": {
"email": "user@example.com",
"valid": true,
"deliverable": true,
"acceptAll": false,
"role": false,
"temporary": false,
"mx": true,
"smtp": true,
"score": 100
},
"error": null
}
]
}
Batch
Get Batch Results
Get batch details and verification results.
GET
/
api
/
v1
/
batches
/
{id}
curl -X GET "https://api.bouncedetector.com/api/v1/batches/507f1f77bcf86cd799439011" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"batch": {
"_id": "507f1f77bcf86cd799439011",
"status": "completed",
"totalCount": 2,
"processedCount": 2,
"createdAt": "2025-03-09T14:30:00.000Z"
},
"emails": [
{
"id": "507f1f77bcf86cd799439013",
"email": "user@example.com",
"status": "verified",
"result": {
"email": "user@example.com",
"valid": true,
"deliverable": true,
"acceptAll": false,
"role": false,
"temporary": false,
"mx": true,
"smtp": true,
"score": 100
},
"error": null
}
]
}
Get batch details and verification results for each email. Replace
{id} with the batch ID returned from Create Batch.
Request
string
required
Batch ID from POST /api/v1/verify/batch
Response
object
Batch metadata (status, totalCount, processedCount, createdAt)
array
List of email verification results with
id, email, status, result, errorcurl -X GET "https://api.bouncedetector.com/api/v1/batches/507f1f77bcf86cd799439011" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"batch": {
"_id": "507f1f77bcf86cd799439011",
"status": "completed",
"totalCount": 2,
"processedCount": 2,
"createdAt": "2025-03-09T14:30:00.000Z"
},
"emails": [
{
"id": "507f1f77bcf86cd799439013",
"email": "user@example.com",
"status": "verified",
"result": {
"email": "user@example.com",
"valid": true,
"deliverable": true,
"acceptAll": false,
"role": false,
"temporary": false,
"mx": true,
"smtp": true,
"score": 100
},
"error": null
}
]
}
Last modified on March 9, 2026