All Products
Search

This Product

    ID Verification:MOBILE_2META

    Document Center

    ID Verification:MOBILE_2META

    Last Updated:Sep 30, 2025

    This topic describes the API operation for Mobile Number Two-Factor.

    API description

    • API operation: Mobile2MetaVerifyIntl

    • Request methods: POST and GET

    • Protocol: HTTPS

    • Description: Verifies the authenticity and consistency of a mobile number and name against an authoritative data source.

    • For API-specific QPS limits, see ID Verification server-side API QPS limits.

    • Endpoints:

      Note

      An internal endpoint refers to the internal communication network between Alibaba Cloud products in the same region. If your business server is deployed in the corresponding Alibaba Cloud region, you can access the ID Verification service through an internal endpoint to ensure more secure and stable network communication.

      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 start debugging and integration, read the Use OpenAPI to debug and integrate server-side APIs document to understand how to call API operations on the OpenAPI platform and obtain the SDK and its code.

    You can use OpenAPI Explorer to directly run and debug this API operation, and generate SDK code examples.

    Request parameters

    Name

    Type

    Required

    Description

    Example

    ProductCode

    String

    Yes

    The product to use. Set this parameter to the static value MOBILE_2META.

    MOBILE_2META

    ParamType

    String

    Yes

    The parameter type:

    • normal: plaintext

    • md5: MD5-encrypted

    normal

    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 to code.

    Success

    Message

    String

    A detailed description of the response code.

    success

    Result

    BizCode

    String

    The verification result:

    • 1: The information is consistent. (Billed)

    • 2: The information is inconsistent. (Billed)

    • 3: No record is found. (Not billed)

    1

    IspName

    String

    The carrier name:

    • CMCC: China Mobile

    • CUCC: China Unicom

    • CTCC: China Telecom

    CMCC

    Response 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 your account has no overdue payments.

    Forbidden.RAMUserAccessDenied

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

    500

    Forbidden.ExceptionDataSource

    An error occurred with the authoritative data source.

    InternalError

    An internal system error occurred. Contact technical support for assistance.