文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>腾讯会议>开放平台文档>服务端 API>REST API 参考>会议报告>用户信息查询>查询个人会议号会议列表

查询个人会议号会议列表

最近更新时间：2025-10-23 17:15:12

我的收藏

本页目录：

接口描述

描述：查询个人会议号（PMI）会议的会议列表（进行中、已结束），目前暂不支持 OAuth 2.0鉴权访问。
请求方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/pmi-meetings


输入参数

以下请求参数列表仅列出了接口请求参数，HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。

查询参数

参数名称
必填
参数类型
参数说明
operator_id
是
String
操作者 ID，即个人会议号拥有者 ID。operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值，operator_id 代表不同类型。
operator_id_type
是
Integer
操作者 ID 的类型：
1：企业用户 userid
3：rooms 设备 rooms_id
instanceid
是
Integer
用户的终端设备类型：
0：PSTN
1：PC
2：Mac
3：Android
4：iOS
5：Web
6：iPad
7：Android Pad
8：小程序
9：voip、sip 设备
10：Linux
12：Vision Pro
20：Rooms for Touch Windows
21：Rooms for Touch macOS
22：Rooms for Touch Android
30：Controller for Touch Windows
32：Controller for Touch Android
33：Controller for Touch iOS
81：HarmonyOS Phone
82：HarmonyOS Tablet
83：HarmonyOS PC
84：HarmonyOS Intelligent Cockpit​​
86：HarmonyOS AR/VR
start_time
否
Integer
查询起始时间，时间区间不超过90天。
end_time
否
Integer
查询结束时间，时间区间不超过90天。
page
否
Integer
当前页，页码起始值为1，默认为1。
page_size
否
Integer
分页大小，默认20条，最大20条。

输出参数

参数名称
参数类型
参数说明
current_page
Integer
当前页。
current_size
Integer
当前实际页大小。
total_count
Integer
数据总条数。
total_page
Integer
数据总页数。
meeting_info_list
会议对象列表。

MeetingInfo 对象

参数名称
参数类型
参数说明
meeting_id
String
会议 ID。
meeting_code
String
有效会议 Code。
subject
String
会议主题。
status
Integer
当前会议状态类型：
-1：非法或未知的会议状态。
0：会议待开始。当前会议待开始，且无参会人进入会议。
1：会议已取消。主持人主动取消的待开始会议，取消后无法再进入会议。
2：会议进行中。当前会议至少有1名参会人在会。
3：会议已删除。会议已过预定结束时间且当前无参会人，经主持人主动删除后，无法再进入会议。
6：会议无状态。会议已过预定结束时间，会议尚无人入会。
7：会议已回收。会议已超过预定开始时间30天，由后台系统自动回收，无法再进入会议。
start_time
Integer
会议预订开始时间（UTC 秒）。
end_time
Integer
会议预订结束时间（UTC 秒）。

错误码列表

状态码
错误码
错误描述
400
190004
参数非法，请对照接口文档检查您的参数。
500
9002
非法请求。
500
190447
用户已禁用。
500
190446
用户未激活。
500
20001
用户不存在。

示例

输入示例

GET https://api.meeting.qq.com/v1/pmi-meetings?operator_id_type=1&operator_id=abcd&instanceid=1&start_time=1679295600&end_time=1679637939&page=1&page_size=20

输出示例

{
    "current_page": 1,
    "current_size": 1,
    "total_count": 1,
    "total_page": 1,
    "meeting_info_list": [
    {
        "meeting_id": "100001",
        "meeting_code": "12345678",
        "subject": "tester's meeting",
        "status": 2, 
        "start_time": 1679295800,
        "end_time": 1679296800
    }
    ]
}

中国站
目录