Skip to main content
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

id
string
required
Batch ID from POST /api/v1/verify/batch

Response

batch
object
Batch metadata (status, totalCount, processedCount, createdAt)
emails
array
List of email verification results with id, email, status, result, error
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
    }
  ]
}

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Response

Batch with results

batch
object
emails
object[]
Last modified on March 9, 2026