Call History

List calls for a customer

get

Retrieves a paginated list of calls (sessions) for a specific customer, including calls to any registered primary and secondary phone numbers.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Bearer {apikey}

Path parameters

agentIdstringRequired

The unique identifier of the agent

customerIdstringRequired

The unique identifier of the customer

Query parameters

limitinteger · min: 1 · max: 100Optional

Maximum number of calls to return

Default: 10

startingAfterstringOptional

Cursor for pagination - returns calls after this call ID

endingBeforestringOptional

Cursor for pagination - returns calls before this call ID

tagsstring[]Optional

Array of tags to filter calls by. Cannot be used together with flags parameter due to limitations.

directionstring · enumOptional

Filter calls by direction

Possible values:

statusstring · enumOptional

Filter calls by status

Possible values:

Responses

200

Successfully retrieved calls

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

get

/v1/agents/{agentId}/customers/{customerId}/call-history

HTTPcURLJavaScriptPython

GET /v1/agents/{agentId}/customers/{customerId}/call-history HTTP/1.1
Host: api.voxity.ai
Authorization: YOUR_API_KEY
Accept: */*

{
  "hasMore": true,
  "data": [
    {
      "id": "text",
      "direction": "inbound",
      "status": "queued",
      "language": [
        "text"
      ],
      "duration": 1,
      "from": "text",
      "to": "text",
      "agentId": "text",
      "customer": {
        "id": "text",
        "displayName": "text",
        "firstName": "text",
        "lastName": "text",
        "alias": "text",
        "photoURL": "text",
        "phoneNumber": {
          "id": "text",
          "phoneNumber": "text",
          "type": "primary",
          "phoneType": "text",
          "lineType": "landline",
          "lineStatus": "active",
          "verified": true,
          "note": "text",
          "conversationSid": "text",
          "createdAt": "2025-12-11T11:00:12.382Z",
          "updatedAt": "2025-12-11T11:00:12.382Z"
        }
      },
      "tags": [
        "text"
      ],
      "flags": [
        "spam"
      ],
      "createdAt": "2025-12-11T11:00:12.382Z",
      "updatedAt": "2025-12-11T11:00:12.382Z"
    }
  ]
}