All Products
Search
Document Center

ID Verification:Server-side HTTP status codes

Last Updated:Jun 24, 2026

This topic describes the HTTP status codes, Code values, and Message parameters returned by the 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 maximum number of repeated exception invocations is exceeded.

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. You can use only one method to upload a portrait image. If the file stream method is used, the system prioritizes this method for the upload.

ToolargeImage

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

DownloadTimeout

The download of the image 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 system error occurred. Contact technical support for troubleshooting.

503

ServiceUnavailable

The service is unavailable. Contact technical support for troubleshooting.