搜索特定通话记录

在 CDR 列表中搜索特定的通话记录。

请求 URL

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

请求参数

注： 如需模糊搜索号码，可通过 编辑通话记录选项 接口启用模糊搜索功能。
参数 是否必填 类型 说明
page 否 Integer 定义显示第几个页面。
注： 如果没有设置此参数，则默认返回第一页。
page_size 否 Integer 定义每页显示几项查询结果。

最大值：10000

注： 如果没有设置此参数，则默认每页返回 10000 项结果。
start_time 否 String 设置用于筛选通话记录的起始时间。
注：
  • 时间可以使用 ISO 8601 日期时间字符串 或 以秒为单位的 Unix 时间戳 的格式传递。
  • 如果使用日期时间格式，则填写的时间格式取决于 PBX 的日期和时间显示格式 (在 PBX 上的 系统 > 日期和时间 > 显示格式 中设置)。
    示例：
    • PBX 的 日期显示格式 为 月/日/年，时间显示格式 为 24 小时制，则此参数的有效时间填写格式为 MM/DD/YYYY HH:mm:ss。
    • PBX 的 日期显示格式 为 年/月/日，时间显示格式 为 12 小时制，则此参数的有效时间填写格式为 YYYY/MM/DD HH:mm:ss AM/PM。
end_time 否 String 设置用于筛选通话记录的结束时间。
注：
  • 时间可以使用 ISO 8601 日期时间字符串 或 以秒为单位的 Unix 时间戳 的格式传递。
  • 如果使用日期时间格式，则填写的时间格式取决于 PBX 的日期和时间显示格式 (在 PBX 上的 系统 > 日期和时间 > 显示格式 中设置)。
    示例：
    • PBX 的 日期显示格式 为 月/日/年，时间显示格式 为 24 小时制，则此参数的有效时间填写格式为 MM/DD/YYYY HH:mm:ss。
    • PBX 的 日期显示格式 为 年/月/日，时间显示格式 为 12 小时制，则此参数的有效时间填写格式为 YYYY/MM/DD HH:mm:ss AM/PM。
call_from 否 String 主叫号码。
call_to 否 String 被叫号码。
pin_code 否 String 通过受 PIN 码限制的呼出路由进行外呼时所使用的，并被记录在通话记录中的 PIN 码。
注：
extension_group 否 Integer 分机组的唯一 ID，用于查询分机组内成员的通话。
注： 可使用 获取菜单选项 接口查询分机组 ID。
disposition_code_list 否 String 话务标签的唯一 ID。
注：
  • 你可以使用 获取菜单选项 接口查询话务标签的 ID。
  • 使用半角逗号 , 分隔多个 ID。
call_note_remark 否 String 备注。
status 否 String 通话状态。
取值范围：
  • ANSWERED：已接
  • NO ANSWER：未接
  • BUSY：忙
  • FAILED：失败
  • VOICEMAIL：语音留言
did 否 String 指定 DID 以筛选通话记录。

取值范围：{did_number}:{trunk_name} 或 {did_name}:{trunk_name}

注：
  • 可使用 搜索特定中继 接口查询中继名称。
  • 使用半角逗号 , 分隔多个 DID。

响应参数

参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
total_number Integer 搜索到的通话记录总数量。
data Array<CDR_Details> 通话记录详细信息。
CDR_Details
参数 类型 说明
id Integer 通话记录的序号。
注： 该字段仅在 83.21.0.66 或更低版本生成的通话记录中返回。
new_id String 通话记录的主键 ID。
注： 该字段仅在 83.21.0.117 或更高版本生成的通话记录中返回。
time String 接听或拨打该通通话的时间。
call_from String 主叫的号码和名称。
call_to String 被叫的号码和名称。
pin_code String 用于外呼的 PIN 码。
timestamp Integer 通话记录时间的时间戳。
uid String 通话记录 (CDR) 的唯一 ID。
src_addr String 主叫 IP 地址。
src_trunk String 来电从哪条中继呼入。
dst_trunk String 去电从哪条中继送出。
duration Integer 拨号开始到通话结束的时间。
ring_duration Integer 拨号开始到通话被应答的时间。
talk_duration Integer 通话被应答到通话结束的时间。
disposition String 通话状态。
  • ANSWERED：已接
  • NO ANSWER：未接
  • BUSY：忙
  • FAILED：失败
  • VOICEMAIL：语音留言
call_type String 通讯类型。
  • Inbound：呼入
  • Outbound：呼出
  • Internal：内部
did_number String 主叫拨打的号码。
dod_number String 被叫话机上显示的号码。
record_file String 通话录音文件名。
reason String 通话结束的原因。
注： 该字段仅在 83.21.0.66 或更低版本生成的通话记录中返回。
call_from_number String 主叫号码。
call_from_name String 主叫名称。
call_to_number String 被叫号码。
call_to_name String 被叫名称。
call_id String 通话的唯一 ID。
call_note Object<Call_Note> 通话备注。
call_note_id String 通话备注的唯一 ID。
enb_call_note Integer 通话备注是否可编辑。
  • 0：不可编辑。
  • 非零值：可编辑。
did String

主叫拨打的号码以及该号码关联的名称。
did_name String

与主叫拨打的号码关联的名称。

Call_Note

参数 类型 说明
id String 通话备注的唯一 ID。
group_id String 通话备注的组 ID。
disposition_code_list Array<Disposition_Codes> 通话备注中选择的话务标签信息。
remark String 备注。
agent_name String 添加通话备注的分机用户的名称。
registration_time Long 分机用户添加通话备注的时间。

Disposition_Codes

参数 类型 说明
id Integer 话务标签的唯一 ID。
name String 话务标签。
description String 话务标签说明。

示例

请求示例

查询分机 1001 在 2025/12/19 10:40:00-2025/12/19 10:45:00 期间拨打电话的通话记录详情 (CDR)。
重要： 如果要通过日期和时间筛选 CDR，start_time 和 end_time 参数的填写格式必须 遵循 PBX 的日期和时间显示格式，否则响应结果中不会返回任何记录。
GET /openapi/v1.0/cdr/search?start_time=2025/12/19 10:40:00&end_time=2025/12/19 10:45:00&access_token=nK3qIHTzFCquRnXz6l1NPB4rVecNXmD6&call_from=1001 HTTP/1.1
192.168.5.150:8088

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "total_number": 3,
    "data": [
         {
            "time": "2025/12/19 10:40:07",
            "call_from": "Phillip Huff<1001>",
            "call_to": "Call Flow aaa<6901>",
            "timestamp": 1766112007,
            "uid": "2025121910400711733",
            "src_addr": "192.168.28.44:5062",
            "duration": 10,
            
            "talk_duration": 10,
            "disposition": "ANSWERED",
            "call_type": "Internal",
            "call_from_number": "1001",
            "call_from_name": "Phillip Huff",
            "call_to_number": "6901",
            "call_to_name": "aaa",
            "call_id": "1766112007.0",
            "call_note": null,
            "call_note_id": "",
            "enb_call_note": 0,
            "did": "",
            "did_name": "",
            "pin_code": "",
            "new_id": "66CD1EAE-AF80033C"
        },
        {
            "time": "2025/12/19 10:40:26",
            "call_from": "Phillip Huff<1001>",
            "call_to": "Call Flow aaa<6901>",
            "timestamp": 1766112026,
            "uid": "2025121910402635715",
            "src_addr": "192.168.28.44:5062",
            "duration": 11,
            
            "talk_duration": 11,
            "disposition": "ANSWERED",
            "call_type": "Internal",
            "call_from_number": "1001",
            "call_from_name": "Phillip Huff",
            "call_to_number": "6901",
            "call_to_name": "aaa",
            "call_id": "1766112026.2",
            "call_note": null,
            "call_note_id": "",
            "enb_call_note": 0,
            "did": "",
            "did_name": "",
            "pin_code": "",
            "new_id": "66CD1EC2-2E0000E6"
        },
        {
            "id": 2710,
            "time": "05/30/2022 14:53:41",
            "call_from": "Kristin Hale<2005>",
            "call_to": "1000",
            "pin_code": "1111",
            "timestamp": 1653893621,
            "uid": "202205301453416CEAB",
            "src_addr": "192.168.28.25",
            "dst_trunk": "peer-to-34",
            "duration": 7,
            
            "talk_duration": 7,
            "disposition": "ANSWERED",
            "call_type": "Outbound",
            "dod_number": "2005",
            "reason": "src hangup    "，
            "call_from_number": "2005",
            "call_from_name": "Kristin Hale",
            "call_to_number": "1000",
            "call_to_name": " ",
            "call_id": "1718690912.7",
            "call_note": {
                "id": "20220530160214-24CE3",
                "group_id": "1745395229.3",
                "disposition_code_list": [
                {
                    "id": 21,
                    "name": "Transferred to Another Department",
                    "description": "The call was transferred to the appropriate team or department."
                }
            ],
               "remark": "User encountered xx issue, needs resolution from the tech support department",
               "agent_name": "Madison Cooper",
               "registration_time": 1741226653,
               "update_entry": ""
            },
            "call_note_id": "20220530160214-24CE3",
            "enb_call_note": 8,
            "did": "123456",
            "did_name": ""
        }
    ]
}