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_timestamp": "2023-11-07T05:31:56Z",
      "call_duration_seconds": 123,
      "credits_used": 123,
      "has_transcript": true,
      "agent_id": "<string>",
      "agent_name": "<string>",
      "call_type": "<string>",
      "from_number": "<string>",
      "to_number": "<string>",
      "transcription_summary": "<string>",
      "transcription_stats": {}
    }
  ],
  "pagination": {
    "current_page": 123,
    "total_pages": 123,
    "total_items": 123,
    "limit": 123,
    "has_next": true,
    "has_previous": true
  }
}

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_id
string

Filter calls by specific agent ID

Response

Successful Response

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