Skip to main content

​
title: “Get Call History” description: “Get call history for a client” api: “GET /api/call-history” authMethod: “key”

​
Get Call History

Get call history for a client. Shows all calls for the client if the user belongs to that client.
Super-admins can see all calls.

​
Parameters

  • Query
    • page (integer, optional, default: 1): Page number (1-indexed)
    • page_size (integer, optional, default: 50, max: 200): Number of records per page

​
Request Example

# API_KEY=your_api_key

curl -H "X-API-Key:$API_KEY" "https://api.vaaniresearch.com/api/call-history?page=1&page_size=50"

​
Response

​
Success Response (200)

{
  "data": [
    {
      "call_id": "room-d99ed871",
      "contact_number": "+917893209830",
      "timestamp": "2026-01-29T12:51:36.087517",
      "status": "NA",
      "agent_id": "d083374a-c167-4bda-b8bc-2a418ca85f35",
      "agent_name": "mohammadmoney-agent",
      "direction": "Outbound",
      "client_id": "0ae0ad3f-00c3-4bac-bd12-e45c948b95b7"
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 50,
    "total_count": 11,
    "total_pages": 1,
    "has_next": false,
    "has_previous": false
  }
}
The response includes a data array of call objects and a pagination block with metadata about pages and result counts. The actual call object contains additional fields such as transcripts, summaries, and metadata which may vary by deployment.

​
Validation Error (422)

{
  "detail": [
    {
        "loc": ["body"],
      "msg": "field required",
      "type": "value_error.missing"
    }
  ]
}
​
detail
array
Array of validation error objects