查询企业帐号拥有的组织

GET

/v1.0/contact/orgAccounts/ownedOrganizations

调用本接口，用于查询企业帐号在哪些企业下拥有创建者身份，并获取这些企业信息。

创建者身份可以在钉钉管理后台-权限管理中查看。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	通讯录企业账号安全数据读写权限	API Explorer
第三方企业应用	暂不支持	通讯录企业账号安全数据读写权限	暂不支持
第三方个人应用	暂不支持	通讯录企业账号安全数据读写权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	exclusive.account.limit	只能操作归属该组织的专属帐号	只能操作归属该组织的专属帐号
400	profile.not.exist	帐号不存在	帐号不存在
400	employee.not.exist	员工不存在	员工不存在
400	invalid.param	无效参数	userId不能为空
500	system.busy	系统繁忙，请稍后再试	系统繁忙，请稍后再试

请求参数

Query 参数

Header 参数

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.dingtalk.com/v1.0/contact/orgAccounts/ownedOrganizations?userId=String' \
--header 'x-acs-dingtalk-access-token;'

响应示例

{
    "orgList": [
        {
            "corpId": "string",
            "corpName": "string"
        }
    ]
}

修改于 2024-01-08 09:11:38

授权企业帐号可加入多组织

企业帐号转交主管理员（创建者）

查询企业帐号拥有的组织

权限#

错误码#

请求参数

返回响应

权限

错误码