List calls

GET

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

Calls

Last modified:2026-03-12 10:32:36

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

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'

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-03-12 10:32:36

Delete a phone number

Get call by ID