All Products
Search
Document Center

ID Verification:Server-side HTTP status codes

Last Updated:Jul 10, 2026

Lists the HTTP status codes, error codes, and messages returned by the ID Verification server.

HTTP status code

Code

Message description

200

Success

The request is successful.

400

MissingParameter

The parameter is required.

InvalidParameter

The parameter is invalid.

TransactionIdInvalid

The Transaction ID is invalid.

401

Forbidden.ExceptionRepeatedInvoke

The number of repeated exception calls exceeds the limit.

UnqualifiedPhoto

The uploaded image is unreadable or does not meet the resolution requirements. Try a different image.

Make sure the photo is clear, properly exposed, fully visible without obstructions, and taken at a straight angle.

DataDuplication

The image was submitted in both Base64 and URL formats. Use only one method to upload a portrait image. If the file stream method is used, it takes priority.

ToolargeImage

The image size exceeds the limit. Compress the image or try a different upload method.

DownloadTimeout

The image download from the URL timed out.

NoFaceDetected

Face feature extraction from the uploaded image failed. Try a different image.

403

Forbidden.RAMUserAccessDenied

Grant the RAM user the AliyunAntCloudAuthFullAccess permission. For more information, see Authorize a RAM user to access ID Verification.

Forbidden.AccountAccessDenied

Make sure that ID Verification is activated and your account has no overdue payments.

Throttling.Api

The API calls exceed the QPS limit.

404

ProcessNotCompleted

The authentication process is not complete.

429

SuspiciousActivity

Restricted by security policies. Try again later. (Applies only to the Device Assistant server-side API)

500

InternalError

An internal error occurred. Contact technical support.

503

ServiceUnavailable

The service is unavailable. Contact technical support.