All Products
Search

This Product

    ID Verification:ID_2META

    Document Center

    ID Verification:ID_2META

    Last Updated:Jun 25, 2026

    Two-factor ID verification API that checks whether a name matches an ID card number

    Two-factor ID verification

    • API operation: Id2MetaVerifyIntl

    • Request method: POST and GET

    • Protocol: HTTPS

    • Description: Checks whether a name matches an ID card number.

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

    • Endpoints:

      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 perform a test and generate an SDK code sample.

    Request parameters

    Name

    Type

    Required

    Description

    Example

    ProductCode

    String

    Yes

    The product code. Fixed value: ID_2META.

    ID_2META

    ParamType

    String

    Yes

    The parameter type.

    normal: Plaintext value.

    Note

    Two-factor ID verification does not support MD5 encryption due to data source limitations.

    normal

    IdentifyNum

    String

    Yes

    The ID card number.

    Note

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

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

    UserName

    String

    Yes

    The name.

    Zhang*

    Response parameters

    Name

    Type

    Description

    Example

    RequestId

    String

    The request ID.

    130A2C10-B9EE-4D84-88E3-5384FF039795

    Code

    String

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

    Success

    Message

    String

    The detailed description of the response code.

    success

    Result

    Object

    None.

    None

    BizCode

    String

    The verification result:

    • 1: Consistent. Billable.

    • 2: Inconsistent. Billable.

    • 3: No record found. Not billable.

    1