查询话单
更新时间：2026-07-31 20:19:05
查询话单
| 名称 | 说明 |
|---|---|
| 接口名称 | 查询话单 |
| 协议 | HTTPS POST |
| URL | https://api.253.com/data/v2/api/voiceMsg/queryVoiceRecord |
| 编码格式 | UTF-8 |
| Content-Type | application/json |
| 返回类型 | application/json |
请求头参数
请求头参数以及生成规则，可参考文档中的通用请求头：通用请求头
请求参数
请求参数 Body 以 application/json（JSON Body）方式提交
| 参数名 | 参数类型 | 是否必传 | 说明 |
|---|---|---|---|
| taskId | String | 否 | 任务id（批量接口查询使用 批量API接口返回的callid） |
| batchNo | String | 否 | 批次号（单条接口查询使用 单条API接口返回的callid） |
| templateId | String | 否 | 模板id |
| startDate | String | 是 | 开始调用时间（yyyy-MM-dd HH:mm:ss，支持查最近90天） |
| endDate | String | 否 | 结束调用时间（yyyy-MM-dd HH:mm:ss） |
| mobile | String | 否 | 被叫号码 |
| messageType | String | 是 | 查询的话单类型：1语音验证码，2国内语音消息 8视频外呼 |
| page | String | 否 | 页码 |
| size | String | 否 | 分页大小（最大100） |
返回参数
| 参数名 | 数据类型 | 参数说明 |
|---|---|---|
| code | String | 响应码，000000：成功，其他失败 |
| msg | String | 响应消息 |
| requestId | String | 请求ID，由网关生成，用于问题排查 |
| data | Object | 响应数据，失败时为 null |
| data>>total | int | 查询总数 |
| data>>pageSize | int | 每页个数 |
| data>>pageNum | int | 页码 |
| data>>list | List | 话单数据 |
| data>>list>>callId | String | 回调的callid |
| data>>list>>callDesc | String | 错误码 |
| data>>list>>callDescMsg | String | 错误描述 |
| data>>list>>mobile | String | 被叫号码 |
| data>>list>>templateId | String | 模板id |
| data>>list>>callState | String | 呼叫状态 0成功 1失败 2未知（空值表示本次通话在进行中 |
| data>>list>>smsStatus | String | 挂机短信状态 0 关闭 1 未发送 2 已发送未回执 3 未知 4 发送成功 5 发送失败 |
| data>>list>>smsSendTime | String | 挂机短信发送时间 13位时间戳 |
| data>>list>>fmsStatus | String | 闪信状态 0 关闭 1 未发送 2 已发送未回执 3 未知 4 发送成功 5 发送失败 |
| data>>list>>recallCount | String | 当前号码第几次呼叫，1：第一次呼叫，2：第二次呼叫 |
| data>>list>>hangupCause | String | 线路挂断原因 |
这篇文档对您有帮助吗？
