Get Batch Call Details
Fetch calls and progress details for one batch call.
/v1 API reference and is the supported path for new integrations. See the migration guide for versioning guidance.callLogs page plus pagination fields such as total, page, limit, and totalPages. Use this endpoint to inspect the calls generated by a batch, render a batch detail page, or verify progress after pausing, resuming, or cancelling a campaign.
When to use this
- Operational dashboards: render the batch detail page with live progress.
- Status polling: review the returned call log page and totals while a campaign is waiting or running.
- Audit logs: inspect the calls created for the batch and their current outcomes.
- Re-run preparation: compare previous call outcomes before creating a new batch with Create Batch Call.
Path parameters
Common query parameters
The returnedcallLogs page supports the same operational filters used by call log browsing.
Errors
404 Not Foundis returned when the batch does not exist.
Related endpoints
- List Batch Calls: browse all batches.
- Create Batch Call: start a new batch.
- Batch calling: guidance on designing a batch.
- Concurrency and limits: pacing batches against your workspace limits.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Batch call ID
"batch_abc123"
Query Parameters
Filter by agent ID(s) - can be a single ID or comma-separated list (e.g., 1,2,3)
Filter by call ID - can be a single ID or comma-separated list (e.g., call_abc,call_def)
Filter by batch call ID - can be a single ID or comma-separated list (e.g., batch_abc,batch_def)
Filter by sender phone number
Filter by recipient phone number
Filter by call type(s) - can be a single value or comma-separated list
phone, web Filter by call direction(s) - can be a single value or comma-separated list
inbound, outbound Filter by minimum latency (in milliseconds)
Filter by maximum latency (in milliseconds)
Filter by agent version ID(s) - can be a single ID or comma-separated list (e.g., 1,2,3)
Search by agent version name (partial match, case-insensitive)
Filter by sentiment(s) - can be a single value or comma-separated list
positive, neutral, negative, unknown Filter by start date (ISO format)
Filter by end date (ISO format)
Filter by minimum call duration (in milliseconds)
Filter by maximum call duration (in milliseconds)
Filter by minimum duration range (in milliseconds)
Filter by maximum duration range (in milliseconds)
Page number (starts from 1)
1
Number of records per page (min: 1, default: 20, max: 200)
20
Sort by created_at (asc or desc)
asc, desc Sort by duration (asc or desc)
asc, desc Filter by call status(es) - can be a single status or comma-separated list
Set to true to export all data without pagination
Filter by end/hangup reason - exact match; comma-separate multiple values for OR filtering