查询邮箱地址状态

POST

/mail/v1/users/query

使用邮箱状态查询接口，可以输入邮箱地址，查询出该邮箱地址对应的类型以及状态。

错误码

HTTP状态码	错误码	描述	排查建议
400	1230001	parameter is invalid	检查邮箱地址是否正确

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://open.feishu.cn/open-apis/mail/v1/users/query' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email_list": [
        "aaa@lark.com"
    ]
}'

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "user_list": [
            {
                "email": "aaa@lark.com",
                "status": 4,
                "type": 1
            }
        ]
    }
}

修改于 2025-10-21 07:44:08

获取用户邮箱所有别名

校验应用管理员

查询邮箱地址状态

错误码#

请求参数

返回响应

错误码