## 話單查詢
>[info] **功能說明**
> 話單信息查詢可以直接查詢數據庫的話單表,也可以通過API接口根據callid查詢,如:用戶是否摘機,通話時長,錄音文件,掛機原因等信息。
> 提示:在“API外呼”、“語音通知”的接口中,都會返回callid
* **請求地址**
```
{base_url}/{api_version}/cdr
```
* **提交數據**
| 參數 | 類型 | 描述 |
| --- | --- | --- |
| callid | string | 本次通話的唯一uuid。|
* **響應參數**
| 參數 | 類型 | 描述 |
| --- | --- | --- |
| callid | string | 本次通話的唯一uuid。|
| start_stamp | datetime | 通話開始時間。 |
| answer_stamp | datetime | 被叫應答時間。|
| end_stamp | datetime | 通話結束時間。|
| billsec | int | 通話時長。|
| ring_duration | int | 座席分機振鈴時長,呼入或API外呼有效(API外呼是系統撥打座席分機,分機振鈴,座席摘機,系統才撥打外線號碼)。|
| ext_duration | int | 座席分機通話時長。|
| call_prefix | string | 中繼的外呼前綴,即自動加撥號碼(后臺中繼管理中配置的外呼前綴參數)。|
| callfrom | string | 主叫號碼。|
| callto | string | 被叫號碼。|
| type | string | 呼叫方向:inbound,outbound。|
| callroter | string | 表示本次呼叫是哪里發起的呼叫,如:API外呼,使用話機直接撥號,語音通知(api,dial,voc)。|
| hangup_cause | string | 掛機原因。|
| hangup_cause_specific | string | 掛機原因的SIP代碼。|
| recording | string | 錄音文件名。|
| trunk_name | string | 本次通話使用的中繼。|
| hangup_firstin | string | 座席和外線誰先掛機(agent/customer)。|
| rtp_use_codec | string | 本次通話使用的語音編碼,如G711,G729等。|
| data | obj | json對象,該值是API外呼或者語音通知提交的data參數值,方便開發者與業務數據匹配或者制作統計報表。|
| callback_domain | string | 回調地址,該值是API外呼或者語音通知提交的callbackDomain參數值。|
| callback_result | string | 回調結果。|
* **響應示例**
```
{
"status": "success",
"data": {
"id": 4,
"callid": "df38656d-7242-4bae-a94b-43dba2d37156",
"start_stamp": "2021-02-19 16:05:08",
"answer_stamp": "2021-02-19 16:05:08",
"bridge_stamp": "2021-02-19 16:05:08",
"end_stamp": "2021-02-19 16:05:17",
"billsec": 9,
"ring_duration": 0,
"ext_duration": 6,
"call_prefix": "",
"callfrom": "8001",
"callto": "13999999999",
"ext": "8001",
"type": "outbound",
"callroter": "api",
"hangup_cause": "NORMAL_CLEARING",
"hangup_cause_specific": "",
"recording": "20210219/202102191602-df38656d-7242-4bae-a94b-43dba2d37156-8001-13999999999.mp3",
"trunk_name": "GSM",
"trunk_number": "",
"hangup_firstin": "agent",
"rtp_use_codec": "G729",
"data": "{"name ": "Alice","age": "20"}",
"callback_domain": "http://www.baidu.com",
"callback_result": "{"status ":"success "}"
},
"msg": ""
}
```