Skip to Content

Download AI Call Transcription Data

Download a JSON file of desired AI call transcription data from CDR, including the call transcript and summary.

Note: This interface is only available in API version 2.0.

Steps to download AI call transcription data

  1. Get the download URL.
  2. Download the JSON file.

Request URL

GET {base_url}/{api_path}/cdr/aidownload?access_token={access_token}

Request parameters

Tip:Use the request parameters to filter the transcription data as needed.

ParameterRequiredTypeDescription
call_fromNoStringNumber of the caller who initiated the call.
call_toNoStringNumber of the caller who received the call.
call_typeNoStringThe communication type of the call.Valid value:
  • Internal
  • Inbound
  • Outbound
start_timeNoStringStart time of the query period.
Note: The time format depends on the date and time display format of PBX (set in System > Date and Time > Display Format on PBX).

Examples:

  • If the display format is Month/Day/Year and is 24-hours format, then the valid time format is MM/DD/YYYY HH:mm:ss.
  • If the display format is Year/Month/Day and is 12-hours format, then the valid time format is YYYY/MM/DD HH:mm:ss AM or YYYY/MM/DD HH:mm:ss PM.
end_timeNoStringEnd time of the query period.
Note: The time format depends on the date and time display format of PBX (set in System > Date and Time > Display Format on PBX).

Examples:

  • If the display format is Month/Day/Year and is 24-hours format, then the valid time format is MM/DD/YYYY HH:mm:ss.
  • If the display format is Year/Month/Day and is 12-hours format, then the valid time format is YYYY/MM/DD HH:mm:ss AM or YYYY/MM/DD HH:mm:ss PM.
last_statusNoStringThe final status of the call.
Valid value:
  • ANSWERED
  • NO ANSWER
  • ABANDONED
  • BUSY
  • FAILED
  • VOICEMAIL

Response parameters

ParameterTypeDescription
errcodeIntegerReturned error code.
  • 0: Succeed.
  • Non-zero value: Failed.
Note: You can check the error code and error message in Error Code and Error Message.
errmsgStringReturned message.
  • SUCCESS: Succeed.
  • FAILURE: Failed.
fileStringThe name of the AI call transcription data JSON file.
download_resource_urlStringThe download URL of the AI call transcription data JSON file.
Note: The download URL is valid only for 30 minutes.

Example

Request example

Get the download URL of the AI call transcription data.

GET /openapi/v2.0/cdr/aidownload?access_token=vtqkVFQcIfbDuWGjSScZk6RGzO0Zdfic HTTP/1.1
192.168.5.150:8088

Response example

{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "file": "PBX-AI_Transcription-X.23.0.70-download-20260514104731-PXFbRkarEjkQzHFL.json",
    "download_resource_url": "/api/download/PBX-AI_Transcription-X.23.0.70-download-20260514104731-PXFbRkarEjkQzHFL.json"
}

Download the AI call transcription data

After obtaining the download URL for the JSON file, combine it with the {base_url} and append the {access_token} parameter. Then, use the complete link to download the desired file.

Download link format

{base_url}/{download_resource_url}?access_token={access_token}

Download link example

https://192.168.5.150:8088/api/download/PBX-AI_Transcription-X.23.0.70-download-20260514104731-PXFbRkarEjkQzHFL.json?access_token=vtqkVFQcIfbDuWGjSScZk6RGzO0Zdfic

Downloaded File Content

The content of the downloaded file is detailed below.

JSON example

 [
    {
        "uid": "20260509214921EFE9A",
        "leg_id": "20260509214921-8AA6D",
        "leg": 1,
        "time": "2026/05/09 21:49:21",
        "call_type": "Internal",
        "call_from": "3200",
        "call_to": "7000",
        "status": "ANSWERED",
        "call_duration": 13,
        "ring_duration": 3,
        "talk_duration": 10,
        "hold_duration": 0,
        "ai_transcription": [
            {
                "source_number": "7000",
                "content": "Hi",
                "timestamp": 1778334561705,
                "duration": 0
            }
        ],
        "ai_summary": "The conversation began with the agent initiating contact with a simple greeting."
    },
    ....
]

Parameter description

ParameterTypeDescription
uidStringThe unique ID of CDR to which the call leg belongs.
leg_idStringThe ID of the call leg.
legIntegerThe sequence number of the call leg in the downloaded data.
timeStringThe time when the call was initiated or received.
call_typeStringThe communication type of the call.
  • Internal
  • Inbound
  • Outbound
call_fromStringThe number of the caller who initiated the call.
call_toStringThe number of the callee who received the call.
statusStringThe final status of the call leg.
  • ANSWERED
  • NO ANSWER
  • BUSY
  • FAILED
  • VOICEMAIL
  • ABANDONED
call_durationIntegerThe time between the call stared and the call ended (in secondes).
ring_durationIntegerThe time between the call started and the call answered (in secondes).
talk_durationIntegerThe time between the call answered and the call ended (in secondes).
Note: The call hold time is excluded.
hold_durationIntegerThe time during which the call is placed on hold (in secondes).
ai_transcriptionArray<Context>AI-generated call transcript content.
ai_summaryStringAI-generated call summary content.

Context

ParameterTypeDescription
source_numberstringThe number of the user who spoke the original content of this record.
contentStringThe transcribed text content.
timestampintegerThe timestamp (in milliseconds) of the original event that generated this transcription record (i.e., when a sentence was spoken).
durationintegerThe length of the original speech that this transcription record corresponds to (in seconds).