All Products
Search

This Product

    ID Verification:MOBILE_3META

    Document Center

    ID Verification:MOBILE_3META

    Last Updated:Nov 06, 2025

    This topic describes the MOBILE_3META API operation.

    API description

    • API operation: Mobile3MetaVerifyIntl

    • Request method: POST and GET

    • Protocol: HTTPS

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

    • QPS limit: This API is subject to an exclusive queries per second (QPS) limit. For more information, see ID Verification server-side API QPS limits.

    • Endpoint:

      Note

      An internal network is a private communication network between Alibaba Cloud products in the same region. If your application server is deployed in an Alibaba Cloud region, you can use the internal endpoint to access the ID Verification service. This provides a more secure and stable network connection.

      China (Hong Kong)

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

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

    Online debugging and integration

    Note

    Before you debug and integrate, read the Use OpenAPI Explorer to debug and integrate server-side API operations document. This document explains how to call API operations on the OpenAPI platform and how to obtain the SDK and its sample code.

    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 solution. Set this parameter to the static field 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

    The return code.

    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

    Return codes

    HTTP status code

    Code

    Description

    200

    Success

    The request was successful.

    400

    MissingParameter

    A parameter cannot be empty.

    Forbidden.ExceptionRepeatedInvoke

    The number of abnormal repeated calls exceeds the limit.

    401

    InvalidParameter

    Invalid parameter.

    403

    Forbidden.AccountAccessDenied

    Activate ID Verification and ensure that your account has no overdue payments.

    Forbidden.RAMUserAccessDenied

    Grant the Resource Access Management (RAM) user the AliyunAntCloudAuthFullAccess permission.

    500

    Forbidden.ExceptionDataSource

    The authoritative data source service is abnormal.

    InternalError

    An internal system error occurred. Contact technical support to troubleshoot the issue.