# 获取频道通话列表 (/zh-CN/api-reference/api-ref/agora-analytics/call-list) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 获取符合指定条件的通话及其基本信息。 - OpenAPI: /openapi/agora-analytics/analytics-rest-api.zh-CN.yaml - Operation ID: get-beta-analytics-call-lists - Method: GET - Path: /beta/analytics/call/lists - Endpoint: https://api.sd-rtn.com/beta/analytics/call/lists ## Servers - https://api.sd-rtn.com ## Authorization This endpoint requires authentication. - `Authorization` ## Parameters - `start_ts` (query, required, number) - 查询的时间范围起点。Unix 时间戳(秒)。 - `end_ts` (query, required, number) - 查询的时间范围终点。Unix 时间戳(秒)。 - `cname` (query, optional, string) - 频道名称 - `appid` (query, required, string) - 你的项目使用的 [App ID](/zh-CN/introduction/glossary#appid)。 - `page_no` (query, optional, number) - 翻页序号。 - Default: `1` - `page_size` (query, optional, number) - 每页的用户通话数,最大不能超过 100。如果指定的值超过 100,每页的用户通话数最多仍为 100 个。 - Default: `20` ## Request body No request body. ## Responses ### 200 OK - `code` (number) - 响应状态码。200 表示请求成功,详见[响应状态码](/zh-CN/realtime-media/usage-analytics/reference/response-code)。 - `message` (string) - 错误消息。 - `requestId` (string) - 对应请求的 ID。 - `total_size` (number) - 返回的用户通话总数。 - `page_no` (number) - 翻页序号。 - `page_size` (number) - 每页的用户通话数。 - `has_more` (boolean) - 是否还有通话未列出。 - `true`:表示符合查询条件的通话没有在 `call_lists` 中全部列出。 - `false`:表示符合查询条件的通话已全部列出。 如果你要查找的通话未列出,请修改查询条件重新发送请求。 - `call_lists` (array) - `call_lists.items` (object) - `call_lists.items.call_id` (string) - 通话 ID,即通话的唯一标识。 - `call_lists.items.cname` (string) - 频道名称。 - `call_lists.items.created_ts` (number) - 通话开始的时间。Unix 时间戳(秒)。 - `call_lists.items.destroyed_ts` (number) - `call_lists.items.finished` (boolean) - `call_lists.items.call_pcu` (number) - 通话级别峰值人数。 - `call_lists.items.call_acu` (number) - `call_lists.items.call_audio_freeze_rate` (number) - `call_lists.items.call_video_freeze_rate` (number) ## Response examples ### 200 ```json { "code": 0, "message": "string", "requestId": "15c99xxxxxxxxxxx9be9b", "total_size": 101, "page_no": 1, "page_size": 20, "has_more": true, "call_lists": [ { "call_id": "cxxxxxxxxxxxxxxxxxxxx", "cname": "cname1", "created_ts": 1547448383, "destroyed_ts": 1547448483, "finished": true, "call_pcu": 2, "call_acu": 2, "call_audio_freeze_rate": 0.12, "call_video_freeze_rate": 0.07 } ] } ```