All Products
Search

This Product

    ID Verification:MOBILE_3META

    Document Center

    ID Verification:MOBILE_3META

    Last Updated:Jun 25, 2026

    Verifies a mobile number, name, and ID card number for consistency against an authoritative data source and returns the reason for any inconsistency

    API description

    • API operation: Mobile3MetaVerifyIntl

    • Request method: POST and GET

    • Protocol: HTTPS

    • Description: Verifies the consistency of a mobile number, name, and ID card number against an authoritative data source. If the information is inconsistent, the reason is returned.

    • QPS limit: Each API has a dedicated QPS limit. For details, see QPS limits of ID Verification server-side APIs.

    • Endpoint:

      Note

      • Benefits of internal network access: An internal network enables private communication between Alibaba Cloud services in the same region. If your application server is also in the same region, use the internal network endpoint to access the ID Verification service for a more secure and stable connection. 

      • Optimization for overseas access: Network conditions outside the Chinese mainland can be complex. To reduce latency and minimize request failures, optimize your integration by following the best practices in Server-side Network Latency Analysis and Optimization.

      China (Hong Kong)

      • Public endpoint: cloudauth-intl.cn-hongkong.aliyuncs.com

      • Internal endpoint: cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

    Online debugging and integration

    Note

    Before you debug or integrate, read the Debug and integrate server-side APIs with OpenAPI guide to understand how to call APIs on the OpenAPI platform and how to obtain the SDK.

    You can run this API operation in OpenAPI Explorer to test it and generate SDK example code for the operation.

    Request parameters

    Name

    Type

    Required

    Description

    Example

    ProductCode

    String

    Yes

    The product code. Set this to the fixed value MOBILE_3META.

    MOBILE_3META

    ParamType

    String

    Yes

    The parameter type:

    • normal: Plaintext

    • md5: MD5 encrypted

    normal

    IdentifyNum

    String

    Yes

    The ID card number. Only ID cards of residents in the Chinese mainland are supported.

    Note

    • If paramType is set to normal, enter the plaintext value.

    • If paramType is set to md5, enter the 32-bit lowercase MD5 string.

    411***********0001

    UserName

    String

    Yes

    The name.

    Note

    • If paramType is set to normal, enter the plaintext value.

    • If paramType is set to md5, enter the 32-bit lowercase MD5 string.

    Zhang*

    Mobile

    String

    Yes

    The mobile number.

    Note

    • If paramType is set to normal, enter the plaintext value.

    • If paramType is set to md5, enter the 32-bit lowercase MD5 string.

    131****8888

    Response parameters

    Name

    Type

    Description

    Example

    RequestId

    String

    The request ID.

    130A2C10-B9EE-4D84-88E3-5384FF03****

    Code

    String

    Return code: For more information, see Server-side HTTP status codes.

    Success

    Message

    String

    The detailed description of the Code.

    success

    ​Result

    BizCode

    String

    The verification result:

    • 1: Consistent (billed)

    • 2: Inconsistent (billed)

    • 3: No record found (not billed)

    1

    SubCode

    String

    The detailed verification result:

    • 101: Verification passed.

    • 201: The mobile number is inconsistent with the name and the ID card number.

    • 202: The mobile number is consistent with the name, but inconsistent with the ID card number.

    • 203: The mobile number is consistent with the ID card number, but inconsistent with the name.

    • 204: Other inconsistencies.

    • 301: No record found.

    101

    IspName

    String

    The carrier name:

    • CMCC: China Mobile

    • CUCC: China Unicom

    • CTCC: China Telecom

    CMCC