查询用户所属用户组

GET

/contact/v3/group/member_belong

通过该接口可查询该用户所属的用户组列表，可分别查询普通用户组和动态用户组。如果应用的通讯录权限范围是“全部员工”，则可获取该员工所属的全部用户组列表。如果应用的通讯录权限范围不是“全部员工”，则仅可获取通讯录权限范围内该员工所属的用户组。点击了解通讯录权限范围。

错误码

HTTP状态码	错误码	描述	排查建议
400	40001	param error	参数错误。
500	40003	internal error	内部错误，请提供 X-Request-Id向客服反馈。联系客服。
400	40011	page size is invalid	无效的分页参数
400	40012	page token is invalid error	page token无效。
400	41071	en_name length exceed 64 character	英文名长度超过64个字符
400	41073	invalid member_id	成员ID 无效
400	41074	invalid member_type	无效的成员类型
403	41050	no user authority error	操作的用户需在通讯录权限范围中，了解更多

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://open.feishu.cn/open-apis/contact/v3/group/member_belong?member_id&member_id_type=&group_type&page_size&page_token' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "group_list": [
            "g193821"
        ],
        "page_token": "AQD9/Rn9eij9Pm39ED40/dk53s4Ebp882DYfFaPFbz00L4CMZJrqGdzNyc8BcZtDbwVUvRmQTvyMYicnGWrde9X56TgdBuS+JKiSIkdexPw=",
        "has_more": false
    }
}

修改于 2025-10-20 09:21:44

查询用户组列表

资源介绍

查询用户所属用户组

错误码#

请求参数

返回响应

错误码