Get call details

Retrieve the details of a specific phone call by its call UUID. The response includes full call metadata, cost breakdown, and agent information.

Path parameters

Parameter	Description	Example
call_uuid	The UUID of the call detail record	CDR8b3e7a1f-6c94-4d52-ae17-5f2b9d4c8e63

cURL

curl -L 'https://api.p.2chat.io/open/voip/call/CDR8b3e7a1f-6c94-4d52-ae17-5f2b9d4c8e63' \
    --header 'X-User-API-Key: your_api_key_here' 

Python

import requests

url = "https://api.p.2chat.io/open/voip/call/CDR8b3e7a1f-6c94-4d52-ae17-5f2b9d4c8e63"

payload = ""
headers = {
  'X-User-API-Key': 'your_api_key_here'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

JavaScript

var axios = require('axios');
var data = '';

var config = {
  method: 'get',
  url: 'https://api.p.2chat.io/open/voip/call/CDR8b3e7a1f-6c94-4d52-ae17-5f2b9d4c8e63',
  headers: { 
    'X-User-API-Key': 'your_api_key_here'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Response

The API will return the full call detail record (CDR) including agent information.

{
    "success": true,
    "cdr": {
        "uuid": "CDR8b3e7a1f-6c94-4d52-ae17-5f2b9d4c8e63",
        "account_uuid": "ACC4d6f2e8a-9b13-4c75-a8d1-6e3f7b5c2a94",
        "callid": "r4kp7wvn2m8x5b3q9cfg",
        "direction": "O",
        "active": false,
        "from": "USR5a8c3e7f-2d14-4b96-a7e3-9f1c6d4b8a52",
        "iso_country_code": "PY",
        "status": "COMPLETED",
        "is_whatsapp_call": false,
        "is_sip_trunk_call": null,
        "created_at": "2025-11-05T17:46:27Z",
        "updated_at": "2025-11-05T17:46:53Z",
        "to_number": "+595984153762",
        "caller_id_uuid": "VCI6a2d8f4e-7c93-4b15-a3e8-1d5f9c7b2a46",
        "caller_id_used": "+61298374152",
        "duration": 3,
        "recording_url": "https://2chat-user-data.s3.amazonaws.com/ACC4d6f2e8a-9b13-4c75-a8d1-6e3f7b5c2a94/calls/r4kp7wvn2m8x5b3q9cfg.mp3",
        "start_time": "2025-11-05T17:46:29Z",
        "end_time": "2025-11-05T17:46:32Z",
        "agent_id": "USR5a8c3e7f-2d14-4b96-a7e3-9f1c6d4b8a52",
        "call_cost": {
            "callid": "r4kp7wvn2m8x5b3q9cfg",
            "forwarded": false,
            "toll_free": false,
            "start_dt": "2025-11-05T17:46:29Z",
            "end_dt": "2025-11-05T17:46:33Z",
            "duration": 4,
            "call_price": 0.0594
        },
        "agent": {
            "uuid": "USR5a8c3e7f-2d14-4b96-a7e3-9f1c6d4b8a52",
            "first_name": "Jane",
            "last_name": "Doe",
            "full_name": "Jane Doe",
            "profile_pic_url": "https://example.com/avatars/jd.png"
        }
    }
}

Response fields

Field	Description	Example values
uuid	Unique identifier of the call detail record	CDR8b3e7a1f-6c94-4d52-ae17-5f2b9d4c8e63
callid	Unique call session identifier	r4kp7wvn2m8x5b3q9cfg
direction	Call direction: O for outbound, I for inbound	O
active	Whether the call is currently in progress	false
from	UUID of the user or number that initiated the call	USR5a8c3e7f-2d14-4b96-a7e3-9f1c6d4b8a52
to_number	Destination phone number in international format	+595984153762
iso_country_code	Two-letter country code of the destination number	PY
status	Final status of the call	COMPLETED
is_whatsapp_call	Whether the call was placed over WhatsApp	false
is_sip_trunk_call	Whether the call was placed over a SIP trunk	null
caller_id_uuid	UUID of the caller ID used for the call	VCI6a2d8f4e-7c93-4b15-a3e8-1d5f9c7b2a46
caller_id_used	Phone number displayed to the recipient	+61298374152
duration	Call duration in seconds	3
recording_url	URL to the call recording file (if available)	https://.../.mp3
start_time	Timestamp when the call was answered	2025-11-05T17:46:29Z
end_time	Timestamp when the call ended	2025-11-05T17:46:32Z
agent_id	UUID of the agent who handled the call	USR5a8c3e7f-2d14-4b96-a7e3-9f1c6d4b8a52

Call cost fields

Field	Description	Example values
callid	Call session identifier matching the parent record	r4kp7wvn2m8x5b3q9cfg
forwarded	Whether the call was forwarded	false
toll_free	Whether the call was to a toll-free number	false
start_dt	Billing start timestamp	2025-11-05T17:46:29Z
end_dt	Billing end timestamp	2025-11-05T17:46:33Z
duration	Billed duration in seconds	4
call_price	Cost of the call in USD	0.0594

Agent fields

Field	Description	Example values
uuid	Unique identifier of the agent	USR5a8c3e7f-2d14-4b96-a7e3-9f1c6d4b8a52
first_name	Agent's first name	Jane
last_name	Agent's last name	Doe
full_name	Agent's full display name	Jane Doe
profile_pic_url	URL to the agent's profile picture	https://example.com/avatars/jd.png