# Error Codes

<table data-full-width="true"><thead><tr><th width="92">Code</th><th width="296">Description</th><th width="308">Message</th><th>Type</th></tr></thead><tbody><tr><td>400</td><td>Bad Request - invalid request received (e.g. missing Bundle key, required parameters or invalid json)</td><td>Make sure all the required parameters are included.</td><td>HTTP</td></tr><tr><td>401</td><td>Invalid API Key</td><td>Make sure you are using the correct credentials and try again.</td><td>HTTP</td></tr><tr><td>403</td><td>Invalid Bundle Key</td><td>Generate and include a valid access token and try again.</td><td>HTTP</td></tr><tr><td>415</td><td>Unsupported Media Type</td><td>Please re-check your image format.</td><td>HTTP</td></tr><tr><td>422</td><td>Unprocessable Entity</td><td>Check the custom error code returned in the response, and refer to the Vlens Error Codes table for more information.</td><td>HTTP</td></tr><tr><td>400</td><td>Base64 Encoding Error</td><td>Please provide a valid base64 encoded image.</td><td>HTTP</td></tr><tr><td>500</td><td>Internal Server Error</td><td>Well-formed request received, but an unexpected error has occurred. Try again later.</td><td>HTTP</td></tr><tr><td>3001</td><td>Document Validation Error "Invalid ID number"</td><td>Error, Please make sure the document is in a good lighting condition and well focused.</td><td>Vlens</td></tr><tr><td>3002</td><td>Document Validation Error "Invalid BirthDate"</td><td>Error, Please make sure the document is in a good lighting condition and well focused.</td><td>Vlens</td></tr><tr><td>3003</td><td>Document Validation Error "Invalid Govern"</td><td>Error, Please make sure the document is in a good lighting condition and well focused.</td><td>Vlens</td></tr><tr><td>3004</td><td>Document Validation Error "Invalid ID_Key"</td><td>Error, Please make sure the document is in a good lighting condition and well focused.</td><td>Vlens</td></tr><tr><td>3005</td><td>Document Validation Error "Invalid Gender"</td><td>Error, Please make sure the document is in a good lighting condition and well focused.</td><td>Vlens</td></tr><tr><td>3006</td><td>Document Validation Error "Invalid releaseDate"</td><td>Error, Please make sure the document is in a good lighting condition and well focused.</td><td>Vlens</td></tr><tr><td>3007</td><td>Wrong date format(BirthDate)</td><td>Make sure dates in the ID are in correct format</td><td>Vlens</td></tr><tr><td>3008</td><td>Wrong date format(releaseDate)</td><td>Make sure dates in the ID are in correct format</td><td>Vlens</td></tr><tr><td>3009</td><td>Wrong date format(ExpiryDate)</td><td>Make sure dates in the ID are in correct format</td><td>Vlens</td></tr><tr><td>3010</td><td>Document Expired</td><td>Make sure the expiry date of the submitted document has not passed.</td><td>Vlens</td></tr><tr><td>3011</td><td>card not detected from image</td><td>Error, Please make sure the document is in a good lighting condition and well focused.</td><td>Vlens</td></tr><tr><td>3013</td><td>Invalid MRZ</td><td>Error, Please make sure the document is in a good lighting condition and well focused.</td><td>Vlens</td></tr><tr><td>3101</td><td>ID number mismatch</td><td>ID number in ID front and back documents are not matched</td><td>Vlens</td></tr><tr><td>3102</td><td>Name mismatch</td><td>Name in ID front and car license documents are not matched</td><td>Vlens</td></tr><tr><td>4001</td><td>Invalid Bundle Key</td><td>Please re-enter your bundle key correctly.</td><td>Vlens</td></tr><tr><td>4002</td><td>Insufficient Quota</td><td>Please recharge your bundle and try again.</td><td>Vlens</td></tr><tr><td>4003</td><td>Exceeded number of trials</td><td>Number of trials exceeded the limit. Try again later.</td><td>Vlens</td></tr><tr><td>4004</td><td>Unregistered Service</td><td>Make sure the service being called is registered in your bundle.</td><td>Vlens</td></tr><tr><td>4005</td><td>Disabled Bundle</td><td>The bundle has been disabled, please contact the server admin for re-activation.</td><td>Vlens</td></tr><tr><td>4006</td><td>Not Subscribed</td><td>You are not subscribed to any bundle </td><td>Vlens</td></tr><tr><td>4007</td><td>Subscription Expired</td><td>Your subscription is expired, please renew your subscription</td><td>Vlens</td></tr><tr><td>4206</td><td>Face Match Error</td><td>Please make sure to have only one face in the image.</td><td>Vlens</td></tr><tr><td>4207</td><td>Face Match Error</td><td>No Face detected</td><td>Vlens</td></tr><tr><td>4208</td><td>Couldn't Extract Facial Features</td><td>Please make sure that there is a face in the image.</td><td>Vlens</td></tr><tr><td>4209</td><td>Face not matching</td><td>Please recapture your face and ensure the capture is clear.</td><td>Vlens</td></tr><tr><td>4210</td><td>Face is not Live</td><td>Please recapture your face and ensure the capture is clear.</td><td>Vlens</td></tr><tr><td>5000</td><td>General Error</td><td>Something went wrong, please contact  support</td><td>Vlens</td></tr><tr><td>5001</td><td>Unsupported Document</td><td>Please enter a supported document.</td><td>Vlens</td></tr><tr><td>5002</td><td>Maximum image size exceeded.</td><td>Make sure each provided image does not exceed the 5MB limit.</td><td>Vlens</td></tr><tr><td>5003</td><td>Maximum image resolution exceeded.</td><td>Make sure each provided image does not exceed the 25 Million pixel limit.</td><td>Vlens</td></tr><tr><td>5004</td><td>Transaction not Found</td><td>Check the Transaction ID/token sent in the request.</td><td>Vlens</td></tr><tr><td>5005</td><td>spoofed doc</td><td>please make sure you're capturing a real document</td><td>Vlens</td></tr><tr><td>5006</td><td>Blurred image</td><td>Please recapture image and make sure it is focused</td><td>Vlens</td></tr><tr><td>5007</td><td>Invalid classification</td><td>Document is supported but wrong end point was called</td><td>Vlens</td></tr><tr><td>5008</td><td>Data Misassigned</td><td>There was an issue assigning data to the correct fields.</td><td>Vlens</td></tr><tr><td>3014</td><td>ID Face Not Detected</td><td>The system could not detect a face in the ID image.</td><td>Vlens</td></tr><tr><td>7000</td><td>Multiple Cards General Error</td><td>A general error occurred while processing multiple cards.</td><td>Vlens</td></tr><tr><td>7001</td><td>ID Front Card General Error</td><td>A general error occurred while processing the front side of the ID card.</td><td>Vlens</td></tr><tr><td>7002</td><td>ID Back Card General Error</td><td>A general error occurred while processing the back side of the ID card.</td><td>Vlens</td></tr><tr><td>7003</td><td>Car License Back Card General Error</td><td>A general error occurred while processing the back side of the car license.</td><td>Vlens</td></tr><tr><td>7004</td><td>Car License Front Card General Error</td><td>A general error occurred while processing the front side of the car license.</td><td>Vlens</td></tr><tr><td>7005</td><td>Driving License Card General Error</td><td>A general error occurred while processing the driving license.</td><td>Vlens</td></tr><tr><td>7006</td><td>Passport Card General Error</td><td>A general error occurred while processing the passport.</td><td>Vlens</td></tr><tr><td>7008</td><td>Face Match General Error</td><td>A general error occurred while matching the face image.</td><td>Vlens</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apidoc.vlens.co/reference/api-reference/error-codes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.