Verify ID Number and Name

Call Alibaba Cloud verification API to verify if the user ID number matches the name.

Endpoint: POST /verify/verify_id_name

---

Request Headers

Parameter	Required	Description
Content-Type	Yes	Fixed value: application/json

---

Request Parameters

Parameter	Type	Required	Format	Description
user_id	string	Yes	18-character string	User ID number
user_name	string	Yes	-	User's name

---

Request Example

{
    "user_id": "110***********1234",
    "user_name": "Example User"
}

---

Response Parameters

Parameter	Type	Required	Description
status	int	Yes	HTTP status code
code	string	Yes	Verification result code
id_name_verify_result	bool	Yes	ID number and name verification result
result	string	Yes	Verification conclusion
raw_data	dict	Yes	Raw data returned by Alibaba Cloud

---

Success Response Example

{
    "status": 200,
    "code": "10000",
    "id_name_verify_result": true,
    "result": "1 : Information verification passed",
    "raw_data": {
        "code": "10000",
        "message": "Success",
        "data": {
            "result": "1",
            "birthday": "****年**月**日",
            "address": "******************",
            "sex": "*"
        },
        "seqNo": "******************"
    }
}

---

Error Response Examples

Endpoint Not Open

{
    "status": 403,
    "id_name_verify_result": false,
    "code": "10017 : Query failed",
    "result": "Server has not opened this endpoint",
    "raw_data": {}
}

Invalid ID Format

{
    "status": 400,
    "code": "10018",
    "id_name_verify_result": false,
    "result": "Invalid ID format",
    "raw_data": {}
}

Invalid Name Format

{
    "status": 400,
    "code": "10018",
    "id_name_verify_result": false,
    "result": "Invalid name format",
    "raw_data": {}
}

Name and ID Do Not Match

{
    "status": 200,
    "id_name_verify_result": false,
    "code": "10000 : Information verification completed",
    "result": "2 : Name and ID do not match",
    "raw_data": {
        "code": "10000",
        "message": "Success",
        "data": {
            "result": "2",
            "birthday": "****年**月**日",
            "address": "******************",
            "sex": "*"
        },
        "seqNo": "******************"
    }
}

Alibaba Cloud API Query Failed

{
    "status": 200,
    "id_name_verify_result": false,
    "code": "10017 : Query failed",
    "result": "3 : Exception occurred",
    "raw_data": {
        "code": "10017",
        "message": "Query failed",
        "data": {
            "result": "3"
        }
    }
}

Alibaba Cloud API System Exception

{
    "status": 200,
    "id_name_verify_result": false,
    "code": "10019 : System exception",
    "result": "3 : Exception occurred",
    "raw_data": {
        "code": "10019",
        "message": "System exception",
        "data": {
            "result": "3"
        }
    }
}

Request Limit Exceeded

{
    "status": 200,
    "id_name_verify_result": false,
    "code": "10021 : Request limit exceeded for same parameters",
    "result": "3 : Exception occurred",
    "raw_data": {
        "code": "10021",
        "message": "Request limit exceeded for same parameters",
        "data": {
            "result": "3"
        }
    }
}

---

Warning

This endpoint requires real-name authentication permissions and is not open in the current version.

Information

When id_name_verify_result is true, it means the ID and name match. When false, they do not match.

The format of the result field is "code : description", where code 1 means match, 2 means mismatch, and 3 means exception.

---

← Back to API Documentation | ← Verify Client Version Number | → Check if User ID is Available