List Calls
List calls for your workspace with pagination, date filters, call id filters, batch call id filters, statuses, sentiments, end reasons, and export mode.
/v1 API reference and is the supported path for new integrations. See the migration guide for versioning guidance.id, current status, agent_id, destination phone number, duration, and creation timestamp. Use this endpoint for lightweight call browsing, status polling against a known set of recent calls, and quick filtering by agent, call id, batch call id, outcome, or time range. ID filters support comma-separated multi-value input.
For richer per-call data, full transcripts, recording URLs, sentiment, and the structured post-call analysis fields configured on the agent, use List Call Logs instead. Call logs carry the analytics payload while /calls is the lightweight scheduling-layer view.
When to use this
- Operational dashboards: render a recent-calls table without paying the cost of full transcripts.
- Live monitoring: quickly filter to
initiatedandin-progresscalls to see active conversations. - Per-agent health checks: filter by
agent_idto spot agents producing unusually high failure rates. - Batch exports: pass
batch_call_idwithexport=trueto download a combined CSV for one or more batches.
Query parameters
Errors
400 Bad Requestis returned when one or more query parameters are invalid.401 Unauthorizedis returned when the API key is missing or invalid.403 Forbiddenis returned when the API key does not have access to this organization.500 Internal Server Erroris returned on an unexpected server-side failure.
Related endpoints
- Get Call Details: fetch a single call’s detail.
- Trigger a Call: start a new outbound call.
- List Call Logs: richer call data with transcript and analysis.
- Pagination: how DialNexa list endpoints paginate.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
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)
Number of records per page (min: 1, default: 20, max: 200)
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
Response
Calls returned successfully.
Signed call ID
"call_abc123"