> For the complete documentation index, see [llms.txt](https://docs.vida.id/identity-stack/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vida.id/identity-stack/verify/liveness/integration/liveness-web-sdk/error-codes.md).

# Error Codes

In this section, you'll find the common errors that may occur during the development and operation of your application. This covers both the error from the SDK and the VIDA backend.

### **SDK Errors**

<table><thead><tr><th width="123.8203125">Code</th><th>Message</th><th>Description</th></tr></thead><tbody><tr><td>40001</td><td>"Unable to proceed, please check your connection"</td><td>Indicates that the user's device is not connected to the internet.</td></tr><tr><td>40002</td><td>"Unable to proceed due to network timeout, please check your connection"</td><td>Indicates that the network request timed out, possibly due to a slow or unstable internet connection.</td></tr><tr><td>40003</td><td>"Unable to proceed, ensure authorization method is correct and token is not expired"</td><td>Indicates that the provided authorization token is invalid or has expired.</td></tr><tr><td>50005</td><td>"Unknown error occurred, please try again later"</td><td>A general error indicating an unknown issue that requires further investigation.</td></tr><tr><td>50006</td><td>"Unknown error occurred during color flash image upload, please try again later"</td><td>The system encountered an unknown error while uploading the color flash image during the liveness process. This may be caused by a temporary network or system issue.</td></tr><tr><td>60003</td><td>"Unknown error while generating hash"</td><td>Indicates an issue occurred while generating a hash, typically during a secure operation.</td></tr><tr><td>70001</td><td>"Unable to proceed, the functionality will not work without Camera permissions"</td><td>Indicates that the SDK does not have the required camera permissions to proceed.</td></tr><tr><td>70002</td><td>"Unable to proceed, failed to download face landmark models"</td><td>Indicates a failure in downloading the required face landmark models, possibly due to network issues.</td></tr><tr><td>70003</td><td>"Unable to proceed, browser or device doesn't support this functionality"</td><td>Indicates that the user's browser or device does not meet the technical requirements to run the SDK.</td></tr><tr><td>70004</td><td>"Unable to proceed, failed to process video frames"</td><td>Indicates that the video frames could not be processed, possibly due to hardware limitations or other issues.</td></tr><tr><td>70005</td><td>"Unable to proceed, No camera device found"</td><td>Indicates that no camera device is detected on the user's system.</td></tr><tr><td>70006</td><td>"Image capture process has failed"</td><td>Indicates that the process to capture an image from the camera has failed.</td></tr><tr><td>70007</td><td>"Detection timed out"</td><td>Indicates that the liveness detection process timed out before completion.</td></tr><tr><td>70008</td><td>"User cancelled liveness process by closing the modal"</td><td>Indicates that the user canceled the liveness detection process by closing the modal dialog.</td></tr><tr><td>70009</td><td>"Camera start process is failed"</td><td>Indicates that the process to start the camera has failed.</td></tr><tr><td>70010</td><td>"Maximum attempt to retry liveness has exhausted, Try again later"</td><td>Indicates that the user has exceeded the maximum number of retry attempts for the liveness process.</td></tr></tbody></table>

### VIDA Backend Error

<table><thead><tr><th width="179">Error Code</th><th width="415">Error Message</th><th>Whitelist</th></tr></thead><tbody><tr><td>1000</td><td>Something went wrong!</td><td></td></tr><tr><td>1039</td><td>Liveness service error</td><td></td></tr><tr><td>1041</td><td>Liveness check failed</td><td>YES</td></tr><tr><td>1057</td><td>Something went wrong!</td><td></td></tr><tr><td>1058</td><td>Please ensure the shot is well-lit and clear</td><td>YES</td></tr><tr><td>1060</td><td>Keep your face straight</td><td>YES</td></tr><tr><td>1062</td><td>Please ensure to open your eyes</td><td>YES</td></tr><tr><td>1074</td><td>The selfie is too dark, ensure the photo is well-lit and clear</td><td>YES</td></tr><tr><td>1075</td><td>The selfie is too bright, ensure the photo is well-lit and clear</td><td>YES</td></tr></tbody></table>

### Color Flash Error

<table><thead><tr><th width="118.29296875">Error Code</th><th width="226.6015625">Error Title</th><th width="247.7890625">Error Detail</th><th>Whitelist</th></tr></thead><tbody><tr><td>1801</td><td>Passive liveness evaluation failed</td><td>Passive liveness failed</td><td></td></tr><tr><td>1802</td><td>Image manipulation evaluation failed</td><td>Image manipulation failed</td><td></td></tr><tr><td>1803</td><td>Color captcha evaluation failed</td><td>Color captcha failed</td><td></td></tr><tr><td>1804</td><td>Multiple model failures</td><td>Multi Model Failure</td><td></td></tr><tr><td>1805</td><td>All model evaluations failed</td><td>Complete model failure</td><td></td></tr><tr><td>1806</td><td>Face Color Issue</td><td>Face has no color reflection</td><td>YES</td></tr><tr><td>1807</td><td>Upstream Service Error</td><td>The request to the document service failed.</td><td></td></tr><tr><td>1808</td><td>Upstream Service Error</td><td>Received an empty or invalid response from the document service.</td><td></td></tr><tr><td>1809</td><td>Not Found</td><td>Captcha payload not found for the given transactionId. The session may have expired.</td><td></td></tr><tr><td>1810</td><td>Upstream Service Error</td><td>The document service returned fewer pre-signed URLs than requested.</td><td></td></tr><tr><td>1811</td><td>Encryption Failed</td><td>Failed to encrypt/decrypt payload.</td><td></td></tr><tr><td>1812</td><td>Color Palette Size Issue</td><td>Color Palette Size Issue</td><td></td></tr></tbody></table>

### Invalid Request or Image Error

<table><thead><tr><th width="125.0078125">Error Code</th><th width="274.7734375">Error Title</th><th>Error Detail</th></tr></thead><tbody><tr><td>1064</td><td>JSON invalid</td><td>Invalid JSON input</td></tr><tr><td>1065</td><td>Image path invalid</td><td>Invalid image path</td></tr><tr><td>1066</td><td>HMAC key missing</td><td>Image quality low</td></tr><tr><td>1067</td><td>HMAC key invalid format</td><td>HMAC key format is invalid</td></tr><tr><td>1068</td><td>HMAC key invalid length</td><td>HMAC key length is invalid</td></tr><tr><td>1069</td><td>HMAC not present in EXIF</td><td>HMAC signature missing in EXIF metadata</td></tr><tr><td>1070</td><td>HMAC signature mismatch</td><td>HMAC signature validation failed</td></tr><tr><td>1071</td><td>HMAC verification error</td><td>Error verifying HMAC signature</td></tr><tr><td>1072</td><td>S3 role resolution failed</td><td>Unable to resolve AWS role for S3 access</td></tr><tr><td>1073</td><td>S3 region resolution failed</td><td>Unable to resolve AWS region for S3</td></tr><tr><td>1081</td><td>S3 role assume denied</td><td>AssumeRole denied for S3 access</td></tr><tr><td>1082</td><td>S3 access denied</td><td>Access denied by S3</td></tr><tr><td>1083</td><td>S3 no such key</td><td>S3 object key not found</td></tr><tr><td>1084</td><td>S3 read failed</td><td>Failed to read object from S3</td></tr><tr><td>1085</td><td>Input encoding failed</td><td>Failed to encode input</td></tr><tr><td>1087</td><td>Internal error</td><td>Unexpected internal error occurred</td></tr><tr><td>4004</td><td>HMAC signature does not match</td><td>HMAC verification failed</td></tr><tr><td>1006</td><td>Missing required parameter</td><td>Validation Failed</td></tr><tr><td>1007</td><td>Bad Request</td><td>The request body is malformed or contains invalid data types.</td></tr><tr><td>1008</td><td>Remote Service Error</td><td>A downstream service is unavailable or returned an unhandled error.</td></tr><tr><td>1056</td><td>No Image Detected</td><td>JPEG decoding error</td></tr><tr><td>1041</td><td>message: Smart liveness score is below threshold</td><td></td></tr></tbody></table>

### Image Quality Error

<table><thead><tr><th width="125.0078125">Error Code</th><th width="274.7734375">Error Title</th><th>Error Detail</th></tr></thead><tbody><tr><td>1086</td><td>Face IQA error</td><td>Face Image Quality Assessment error</td></tr><tr><td>1051</td><td>Detect Un-standardized Image Quality</td><td>Face Occluded</td></tr><tr><td>1052</td><td>Detect Un-standardized Image Quality</td><td>Face too small</td></tr><tr><td>1053</td><td>Detect Un-standardized Image Quality</td><td>Image quality low</td></tr><tr><td>1054</td><td>Detect Un-standardized Image Quality</td><td>More than one face</td></tr><tr><td>1055</td><td>Detect Un-standardized Image Quality</td><td>No face detected</td></tr><tr><td>1074</td><td>Image Quality Is Below Threshold</td><td>Under Exposure</td></tr><tr><td>1075</td><td>Image Quality Is Below Threshold</td><td>Over Exposure</td></tr><tr><td>1063</td><td>Image Quality Is Below Threshold</td><td>Unnatural colour</td></tr><tr><td>1076</td><td>Image Quality Is Below Threshold</td><td>Image Is Blur</td></tr></tbody></table>