Retrieve a call record

GET/api/v1/domains/{domain_uuid}/cdrs/{xml_cdr_uuid}

Retrieve the details of one call using its call history ID.

Path parameters

domain_uuidstringrequired

Your company ID supplied by Junction Cloud Connections. Use the same ID throughout your requests.

xml_cdr_uuidstringrequired

The CDR UUID.

Responses

200Success

xml_cdr_uuidstring

objectstring

domain_uuidstring

sip_call_idstring

extension_uuidstring

call_center_queue_uuidstring

recording_uuidstring

directionstring

caller_id_namestring

caller_id_numberstring

caller_destinationstring

destination_numberstring

start_epochinteger

answer_epochinteger

end_epochinteger

durationinteger

hangup_causestring

hangup_cause_q850string

voicemail_messageboolean

cc_cancel_reasonstring

cc_causestring

sip_hangup_dispositionstring

statusstring

call_dispositionstring

call_flowarray[object]

Show nested fields

destination_numberstring

contextstring

bridged_timestring

created_timestring

answered_timestring

progress_timestring

transfer_timeinteger

profile_created_timestring

profile_end_timestring

progress_media_timestring

hangup_timestring

duration_secondsinteger

duration_formattedstring

call_dispositionstring

time_linestring

dialplan_appstring

dialplan_namestring

dialplan_descriptionstring

400Invalid CDR UUID

errorobject

Show nested fields

typestring

messagestring

codestring

paramstring

401Unauthenticated

errorobject

Show nested fields

typestring

messagestring

codestring

404CDR not found

errorobject

Show nested fields

typestring

messagestring

codestring

paramstring

REQUEST EXAMPLE

Replace the host, token and example IDs with your account details.

curl --request GET \
  --url "https://YOUR-PORTAL-HOST/api/v1/domains/YOUR_COMPANY_UUID/cdrs/40aec3e8-a572-40da-954b-ddf6a8a65324" \
  --header "Authorization: Bearer $JUNCTIONCC_API_TOKEN" \
  --header "Accept: application/json"

const token = process.env.JUNCTIONCC_API_TOKEN;

const response = await fetch("https://YOUR-PORTAL-HOST/api/v1/domains/YOUR_COMPANY_UUID/cdrs/40aec3e8-a572-40da-954b-ddf6a8a65324", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json"
  }
});

if (!response.ok) throw new Error(`HTTP ${response.status}`);
const text = await response.text();
console.log(text ? JSON.parse(text) : null);

import json
import os
from urllib.request import Request, urlopen

request = Request(
    "https://YOUR-PORTAL-HOST/api/v1/domains/YOUR_COMPANY_UUID/cdrs/40aec3e8-a572-40da-954b-ddf6a8a65324",
    method="GET",
    headers={
        "Authorization": "Bearer " + os.environ["JUNCTIONCC_API_TOKEN"],
        "Accept": "application/json"
    }
)
with urlopen(request, timeout=30) as response:
    body = response.read()
    print(json.loads(body) if body else None)

RESPONSE EXAMPLE

{
  "xml_cdr_uuid": "40aec3e8-a572-40da-954b-ddf6a8a65324",
  "object": "cdr",
  "domain_uuid": "7d58342b-2b29-4dcf-92d6-e9a9e002a4e5",
  "sip_call_id": "0f4b17db-3ef1-476d-b6e7-bcfe07dfd001",
  "extension_uuid": "c9a76140-0ca4-4ea3-95af-7e12c2ff0df5",
  "call_center_queue_uuid": null,
  "recording_uuid": "40aec3e8-a572-40da-954b-ddf6a8a65324",
  "direction": "inbound",
  "caller_id_name": "John Smith",
  "caller_id_number": "2135551212",
  "caller_destination": "1001",
  "destination_number": "1001",
  "start_epoch": 1775787900,
  "answer_epoch": 1775787905,
  "end_epoch": 1775787960,
  "duration": 60,
  "hangup_cause": "NORMAL_CLEARING",
  "hangup_cause_q850": "16",
  "voicemail_message": false,
  "cc_cancel_reason": null,
  "cc_cause": null,
  "sip_hangup_disposition": "recv_bye",
  "status": "answered",
  "call_disposition": "The caller hung up.",
  "call_flow": [
    {
      "destination_number": "1001",
      "context": "example.com",
      "bridged_time": "2026-04-01 12:00:05",
      "created_time": "2026-04-01 12:00:00",
      "answered_time": "2026-04-01 12:00:05",
      "progress_time": "2026-04-01 12:00:01",
      "transfer_time": 0,
      "profile_created_time": "2026-04-01 12:00:00",
      "profile_end_time": "2026-04-01 12:01:00",
      "progress_media_time": "2026-04-01 12:00:01",
      "hangup_time": "2026-04-01 12:01:00",
      "duration_seconds": 60,
      "duration_formatted": "1 min 00 s",
      "call_disposition": "answered",
      "time_line": "00:00",
      "dialplan_app": "Extension",
      "dialplan_name": "John Smith",
      "dialplan_description": null
    }
  ]
}

{
  "error": {
    "type": "invalid_request_error",
    "message": "Invalid CDR UUID.",
    "code": "invalid_request",
    "param": "xml_cdr_uuid"
  }
}

{
  "error": {
    "type": "authentication_error",
    "message": "Unauthenticated.",
    "code": "unauthenticated"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "message": "CDR not found.",
    "code": "resource_missing",
    "param": "xml_cdr_uuid"
  }
}