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

{% hint style="info" %}
The errors which are highlighted as **YES** in the customizable column can be customised by the Host application
{% endhint %}

### SDK Errors

<table><thead><tr><th width="156">Error Code</th><th width="414">Error Message</th><th>Whitelist</th></tr></thead><tbody><tr><td>40001</td><td>Unable to proceed please check your connection</td><td></td></tr><tr><td>40002</td><td>Unable to proceed due to network timeout, please check your connection  or  &#x3C;Empty message in some cases></td><td>YES</td></tr><tr><td>40003</td><td>Unable to proceed, ensure that the authorization method is correct</td><td>YES</td></tr><tr><td>40004</td><td>Unable to proceed due to unknown network, please reconnect again</td><td>YES</td></tr><tr><td>40005</td><td>Unable to proceed, please check your internet connection</td><td>YES</td></tr><tr><td>40006</td><td>Unable to proceed, please check your internet connection or &#x3C;actual error message ></td><td>YES</td></tr><tr><td>40007</td><td>Unable to proceed please check your connection</td><td>YES</td></tr><tr><td>50001</td><td>Received a null response from the server</td><td></td></tr><tr><td>50002</td><td>Internal server error</td><td>YES</td></tr><tr><td>50003</td><td>Something went wrong, please try again later</td><td></td></tr><tr><td>50004</td><td>Invalid parameters %1$s</td><td></td></tr><tr><td>50005</td><td>Something went wrong, please try again later</td><td></td></tr><tr><td>50007</td><td>Something went wrong, please try again later</td><td></td></tr><tr><td>50008</td><td>Something went wrong, please try again later</td><td></td></tr><tr><td>50009</td><td>Unable to parse the information</td><td></td></tr><tr><td>50010</td><td>Something went wrong, please try again later</td><td></td></tr><tr><td>50012</td><td>Liveness detection is in progress</td><td></td></tr><tr><td>50013</td><td>License key not found</td><td></td></tr><tr><td>50014</td><td>Something went wrong, please try again later</td><td></td></tr><tr><td>50017</td><td>Internal Server Error</td><td></td></tr><tr><td>50018</td><td>Something went wrong, please try again later</td><td></td></tr><tr><td>50019</td><td>Liveness SDK is not initialized. Initialize it first</td><td></td></tr><tr><td>50020</td><td>Liveness check is not configured, please check with support team</td><td></td></tr><tr><td>50021</td><td><p>Landscape orientation not supported.</p><p>Please rotate in portrait orientation.</p></td><td></td></tr><tr><td>50022</td><td>Liveness image upload failed color flash flow</td><td></td></tr><tr><td>50023</td><td>Back camera not supported for the selected configuration (color flash flow)</td><td></td></tr><tr><td>60001</td><td>Crypto error. Unable to encrypt request</td><td></td></tr><tr><td>60002</td><td>Crypto error. Unable to decrypt response</td><td></td></tr><tr><td>60003</td><td>Unknown error while generating hash</td><td></td></tr><tr><td>60004</td><td>Unknown error while encrypting the data</td><td></td></tr><tr><td>60005</td><td>Unknown error while fetching store key</td><td></td></tr><tr><td>60006</td><td>Device Id not found in the keychain</td><td></td></tr><tr><td>60007</td><td>Device ID could not be decrypted. Device ID or Keychain might be tampered.</td><td></td></tr><tr><td>70001</td><td>Unable to proceed, the functionality will not work without Camera permissions</td><td></td></tr><tr><td>70002</td><td>Face detection failed with error : %1$s</td><td></td></tr><tr><td>70003</td><td>Failed to get image result</td><td></td></tr><tr><td>70004</td><td>Liveness detection is canceled</td><td></td></tr><tr><td>70005</td><td>Retrying liveness detection activity</td><td></td></tr><tr><td>70006</td><td>Image capture process has failed</td><td></td></tr><tr><td>70007</td><td>Detection timed out</td><td></td></tr><tr><td>70008</td><td>User canceled liveness process by clicking back button</td><td></td></tr><tr><td>70009</td><td>Camera start process is failed</td><td></td></tr><tr><td>70010</td><td>Maximum attempt to retry liveness has exhausted</td><td></td></tr><tr><td>70011</td><td>You cannot use the zoomFace gesture with other gestures. Please refer to documentation for more details</td><td></td></tr><tr><td>70012</td><td>Liveness detection failed</td><td></td></tr><tr><td>70013</td><td>Please make sure to add ID Fraud shield SDK dependency</td><td></td></tr><tr><td>70013</td><td>ID fraud shield clientID is missing, please check with support team</td><td></td></tr><tr><td>70014</td><td>Liveness detection interrupted</td><td></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>1047</td><td>Unable to detect face from selfie image</td><td></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>