Introducing VIDA Identity Stack: All of VIDA, in one place 🎉
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Error Code

The table includes the HTTP status codes, VIDA codes, error titles, error descriptions, and recommendations for each error scenario described in the JSON responses.

Status Code
VIDA Code
Error Title
Error Description
Recommendation

400

1006

Missing required parameter

Either some of the mandatory parameters are missing or invalid value is supplied for a required parameter.

Ensure all required parameters are passed correctly.

500

1039

Liveness Service Error

Something went wrong in our service while processing the request.

N/A

200

1043

Selfie photo is a live

The system detected a higher confidence of live selfie when the liveness score < 0.95 and image manipulation score is < 0.95 (if image manipulation is enabled)

N/A

200

1041

Photo liveness score is below the threshold

The system detected a higher confidence of spoofed or hacked selfie when the liveness score >= 0.95.

N/A

400

1051

Detect Un-standardized Image Quality

Face Occluded

Ensure there is no occluded object when capturing the selfie.

400

1052

Detect Un-standardized Image Quality

Face too small

Capture the face size area greater than 50x50 pixels.

400

1053

Detect Un-standardized Image Quality

Image quality low

Ensure the image input is in good quality condition.

400

1054

Detect Un-standardized Image Quality

More than one face

Ensure that only one face is in the frame.

400

1055

Detect Un-standardized Image Quality

No face detected

Ensure at least one face is present and visible in the frame or in good lighting condition.

400

1056

No Image Detected

Invalid base64 or no image present in the provided base64

Ensure the base64 is correct and contains an image.

400

1063

Image Quality Is Below Threshold

Unnatural colour

Ensure that the face selfie well lit, clean and undamage

400

1074

Image Quality Is Below Threshold

Under Exposure

Ensure that the face selfie well lit and properly exposed

400

1075

Image Quality Is Below Threshold

Over Exposure

Ensure that the face selfie properly exposed with no blown-out highlights

400

1076

Image Quality Is Below Threshold

Image is Blur

Ensure that the face selfie is sharp and in focus

404

1602

Transaction Not Found

There is no transaction saved for the given the transactionId

Ensure that the transaction id sent is correct

404

1603

Could not fetch the scores for the given transaction

We were unable to get the scores for the given transaction.

Ensure that you fetch details for transactions that completed successfully

404

1604

Image not found for given transaction.

We were unable to get the image for the given transaction.

Ensure that you fetch details for transactions that completed successfully

200

1705

Fraud shield risk level exceeded error threshold

Fraud shield risk level exceeded error threshold

200

1706

Fraud shield risk transaction detail not found

Fraud shield risk transaction detail not found

Last updated