Call
List calls
Returns a paginated list of calls for the authenticated project.
get/v1/call
Query parameters
limitinteger
Maximum number of calls to return (default: 20, max: 100)
Example:20
afterstring
Cursor for pagination - use the nextCursor value from a previous response
Example:eyJzb3J0VmFsdWUiOiIyMDI1LTAxLTE1VDEwOjAwOjAwLjAwMDAwMFoiLCJpZCI6IjU1MGU4NDAwLWUyOWItNDFkNC1hNzE2LTQ0NjY1NTQ0MDAwMCJ9
sortBy'createdAt' | 'startedAt' | 'endedAt' | 'duration' | 'title' | 'status'
Field to sort by (default: createdAt)
Example:createdAt
sortDirection'asc' | 'desc'
Sort direction (default: desc)
Example:desc
status'RINGING' | 'IN_PROGRESS' | 'ENDED'
Filter by call status
Example:ENDED
searchTextstring
Search text to filter calls by title, summary, or transcript
Example:billing inquiry
simulationRunPlanJobIdstring uuid
Filter by simulation run plan job ID to get all calls from a specific simulation batch
Example:550e8400-e29b-41d4-a716-446655440000
Response
List of calls
Example response
{
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"projectId": "660e8400-e29b-41d4-a716-446655440001",
"title": "Customer support inquiry",
"summary": "Customer inquired about billing and payment options",
"status": "ENDED",
"callDirection": "INBOUND",
"startedAt": "2024-01-15T10:00:00Z",
"endedAt": "2024-01-15T10:30:00Z",
"durationMs": 1800000,
"endedStatus": "AGENT_ENDED_CALL",
"recordingUrl": "https://s3.amazonaws.com/bucket/recording.mp3?...",
"simulationJobId": "880e8400-e29b-41d4-a716-446655440003",
"supersededByCallId": "990e8400-e29b-41d4-a716-446655440004",
"agents": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"endpoint": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"environment": "Production",
"phoneNumberE164": "+1234567890"
}
}
],
"customers": [
{
"phoneNumberE164": "+1234567891",
"label": "customer-01"
}
],
"createdAt": "2024-01-15T10:31:00Z",
"updatedAt": "2024-01-15T10:31:00Z",
"properties": {
"customerId": "cust_123",
"department": "sales"
},
"policyIds": [
"550e8400-e29b-41d4-a716-446655440000"
]
}
]
}