Skip to main content
GET
/
api
/
v1
/
batches
curl -X GET "https://api.bouncedetector.com/api/v1/batches?limit=10&skip=0" \
  -H "Authorization: Bearer YOUR_API_KEY"

[
  {
    "_id": "507f1f77bcf86cd799439011",
    "status": "completed",
    "totalCount": 10,
    "processedCount": 10,
    "createdAt": "2025-03-09T14:30:00.000Z"
  },
  {
    "_id": "507f1f77bcf86cd799439012",
    "status": "processing",
    "totalCount": 100,
    "processedCount": 45,
    "createdAt": "2025-03-09T14:25:00.000Z"
  }
]
List your team’s batch jobs. Pagination via limit and skip query parameters.

​
Request

​
limit
number
default:"50"
Max number of results
​
skip
number
default:"0"
Number of results to skip (offset)

​
Response

Returns an array of batch objects with _id, status, totalCount, processedCount, createdAt. 
curl -X GET "https://api.bouncedetector.com/api/v1/batches?limit=10&skip=0" \
  -H "Authorization: Bearer YOUR_API_KEY"

[
  {
    "_id": "507f1f77bcf86cd799439011",
    "status": "completed",
    "totalCount": 10,
    "processedCount": 10,
    "createdAt": "2025-03-09T14:30:00.000Z"
  },
  {
    "_id": "507f1f77bcf86cd799439012",
    "status": "processing",
    "totalCount": 100,
    "processedCount": 45,
    "createdAt": "2025-03-09T14:25:00.000Z"
  }
]

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
limit
integer
default:50
​
skip
integer
default:0

Response

List of batches

​
id
string
​
status
enum<string>
Available options:
pending,
processing,
completed,
failed,
cancelled
​
totalCount
integer
​
processedCount
integer
​
createdAt
string<date-time>
Last modified on March 9, 2026