List calls

GET

https://api.hmsovereign.com/api/v1/calls

Calls

Last modified:2026-01-30 13:43:45

Maintainer:Jesper Rietbergen

Retrieve call history with optional filtering by status and date range. Returns complete call data including transcripts, analysis results, and metadata.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

List of calls

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.hmsovereign.com/api/v1/calls?limit&offset&status&start_date&end_date' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "calls": [
        {
            "id": "call-_+31623731537_XqaQxRRgAzYc",
            "caller_phone": "+31623731537",
            "assistant_phone": "+31850835037",
            "status": "connecting",
            "error": "string",
            "started_at": "2019-08-24T14:15:22.123Z",
            "ended_at": "2019-08-24T14:15:22.123Z",
            "duration_seconds": 120,
            "summary": "string",
            "analysis_result": {
                "summary": "string",
                "sentiment": 8
            },
            "messages": [
                {
                    "role": "assistant",
                    "content": "Hello, how can I help you?"
                },
                {
                    "role": "user",
                    "content": "Hi, can you hear me?"
                }
            ],
            "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
            "number_id": "7f8a9b2c-3d4e-5f6g-7h8i-9j0k1l2m3n4o",
            "agent_name": "string",
            "business_name": "string",
            "phone_number": "+31850835037",
            "created_at": "2019-08-24T14:15:22.123Z",
            "updated_at": "2019-08-24T14:15:22.123Z"
        }
    ],
    "pagination": {
        "total": 42,
        "limit": 100,
        "offset": 0
    }
}

Modified at 2026-01-30 13:43:45

Delete a phone number

Get call by ID