Batch Calls
List Batch Calls
List batch call jobs for your workspace and filter by draft, waiting, scheduled, running, paused, completed, cancelled, deleted, or legacy active status.
GET
List Batch Calls
Read only
Returns every batch call job in your workspace, paginated and sorted by creation date (newest first). Each entry includes the batch’s display
Recommended. This endpoint is part of the public
/v1 API reference and is the supported path for new integrations. See the migration guide for versioning guidance.name, the current status, the totals of attempted and completed calls, and the creation timestamp. Use List Batch Calls to power a batch history dashboard, build automation that watches for new batches, or audit which jobs have run in a given period.
When to use this
- Operational dashboards: render a batch history view with progress bars.
- Compliance audits: list every batch run in a quarter for review.
- Reporting pipelines: sync batch metadata into a data warehouse alongside call logs.
- Automation triggers: detect newly created batches and start downstream reporting jobs.
Query parameters
Errors
403 Forbiddenis returned when the API key cannot read batch jobs on this workspace.
Related endpoints
- Get Batch Call: fetch a single batch’s detail.
- Create Batch Call: start a new batch.
- Pagination: how DialNexa list endpoints paginate.
- Batch calling: guidance on designing a batch.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Example:
20
Example:
1
Filter by batch status - can be a single status or comma-separated list. Supported values include draft, waiting, scheduled, running, paused, completed, cancelled, deleted, and legacy active.
List Batch Calls