Skip to main content
GET
/
api
/
v1
/
agent
/
call-history
Call History
curl --request GET \
  --url https://dev.voice.ai/api/v1/agent/call-history \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": 123,
      "call_id": "call_01JABCDEF23456789XYZ",
      "agent_id": "agent_123",
      "agent_name": "Support Agent",
      "call_timestamp": "2026-03-01T18:42:11Z",
      "call_duration_seconds": 184.5,
      "credits_used": 3.69,
      "has_transcript": true,
      "call_type": "web",
      "from_number": null,
      "to_number": null,
      "transcription_summary": "Customer asked about account access and password reset.",
      "transcription_stats": {
        "duration_seconds": 184.5,
        "speaker_turns": 14
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "total_pages": 1
  }
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your API key as the bearer token. Format: Authorization: Bearer

Query Parameters

​
page
integer
default:1
Required range: x >= 1
​
limit
integer
default:10
Required range: 1 <= x <= 100
​
start_date
string

Filter calls after this date (ISO format UTC, e.g., 2024-01-01T00:00:00+00:00)

​
end_date
string

Filter calls before this date (ISO format UTC, e.g., 2024-12-31T23:59:59+00:00)

​
agent_ids
string[]

Filter calls by agent ID(s). Can provide multiple agent IDs as a list (e.g., ?agent_ids=agent1&agent_ids=agent2). Filter calls by agent ID(s). Can provide multiple agent IDs as a list.

Response

Successful Response - Returns paginated call history items, including the stable call_id for each call.

​
items
CallHistoryItem · object[]
required
​
pagination
PaginationMeta · object
required