# 查询实名认证信息-ShowRealNameAuthStatus
#### 功能介绍
客户在自建平台查询实名认证信息。
#### 接口约束
该接口使用客户AK/SK或者Token调用。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BSS&api=ShowRealNameAuthStatus)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
当前API调用无需授权。
#### URI
GET /v2/customers/real-name-auth-status
#### 请求消息
**请求参数**
无。
**请求示例**
```
GET https://bss.myhuaweicloud.com/v2/customers/real-name-auth-status HTTP/1.1
Content-Type: application/json
X-Auth-Token: MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
```
#### 响应消息
**响应参数**
| 参数              | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|
| error_code      | String  | **参数解释：** 状态码。具体请参考[状态码]。只有失败才返回该字段。 **取值范围：** 最大长度：20                                                                                                                                                                                                                                               |
| error_msg       | String  | **参数解释：** 错误描述信息。只有失败才返回该字段。 **取值范围：** 最大长度：1000                                                                                                                                                                                                                                                                                         |
| verified_status | Integer | **参数解释：** 实名认证状态 。 **取值范围：** - -1：未实名认证  - 0：实名认证审核中  - 1：实名认证不通过  - 2：已实名认证   |
| verified_type   | Integer | **参数解释：** 实名认证类型。未实名认证状态返回null。 **取值范围：** - 0：个人实名认证  - 1：企业实名认证                                                                                                                       |
   
**响应示例**
```
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  
{
    "verified_status": 2,
    "verified_type": 0
}
```
 #### 状态码
![](https://support.huaweicloud.com/api-oce/public_sys-resources/note_3.0-zh-cn.png)
- 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
- 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。
 
| HTTP状态码 | 错误码      | 错误描述  |
|:---|:---|:---|
| 403     | CBC.0151 | 访问拒绝。 |
| 500     | CBC.0999 | 其他错误。 |
| 400     | CBC.0100 | 参数错误。 |