获取部门企业账号用户详情

POST

https://oapi.dingtalk.com/topapi/v2/user/list

调用本接口获取指定部门中的用户详细信息。

使用说明

获取部门企业用户详情接口，仅支持购买开通企业账号的组织使用。

本接口只支持获取指定部门下的员工详情信息，无法获取子部门员工信息。

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	开发者后台申请权限：查询行业通讯录信息权限	调试
第三方企业应用	是	开发者后台申请权限：查询行业通讯录信息权限	调试
第三方个人应用	否	—	—

错误码

错误码（errcode）	错误码描述（errmsg）	解决方案
400002	无效的参数	请确认参数是否按要求填写
50004	部门不在权限范围内	请确认access_token具有操作权限
40035	参数非法	dept_id或cursor或size或order_field填写不合规范
60019	未能从部门中获取用户	请确认相关参数填写正确
-1	系统繁忙	请稍后再试

请求参数

Query 参数

Body 参数application/json

示例

{
        "cursor":"0",
        "contain_access_limit":"false",
        "size":"10",
        "order_field":"modify_desc",
        "language":"zh_CN",
        "dept_id":"10"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://oapi.dingtalk.com/topapi/v2/user/list?access_token' \
--header 'Content-Type: application/json' \
--data-raw '{
        "cursor":"0",
        "contain_access_limit":"false",
        "size":"10",
        "order_field":"modify_desc",
        "language":"zh_CN",
        "dept_id":"10"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "errcode": "string",
    "result": {
        "next_cursor": "string",
        "has_more": "string",
        "list": {
            "leader": "string",
            "exclusive_account_type": "string",
            "extension": "string",
            "unionid": "string",
            "boss": "string",
            "exclusive_account": "string",
            "admin": "string",
            "remark": "string",
            "title": "string",
            "hired_date": "string",
            "userid": "string",
            "work_place": "string",
            "nickname": "string",
            "dept_id_list": "string",
            "job_number": "string",
            "email": "string",
            "dept_order": "string",
            "login_id": "string",
            "exclusive_account_corp_name": "string",
            "mobile": "string",
            "active": "string",
            "telephone": "string",
            "avatar": "string",
            "hide_mobile": "string",
            "exclusive_account_corp_id": "string",
            "org_email": "string",
            "name": "string",
            "state_code": "string"
        }
    },
    "errmsg": "string"
}

修改于 2025-09-08 06:28:05

查询企业账号用户详情

根据手机号查询企业账号用户

获取部门企业账号用户详情

使用说明#

权限#

错误码#

请求参数

请求示例代码

返回响应

使用说明

权限

错误码