> 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/kyc-mobile-sdk/integration-overview/ios-sdk/error-code.md).

# Error Code

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.

For further detailed info regarding error codes of OCR and Document Verification, please refer to this page [here](https://app.gitbook.com/o/HFo4Mq4hPbfFvhTREpfY/s/zqikP7fR7hLesltIaRUc/integration-methods/api/document-ai/ocr-and-document-verification-v2/http-status-and-error-codes)

### VIDA SDK Error Codes <a href="#sdk-errors" id="sdk-errors"></a>

<table data-header-hidden><thead><tr><th width="196.2393798828125">Value</th><th>Description</th></tr></thead><tbody><tr><td><strong>Value</strong> </td><td><strong>Description</strong></td></tr><tr><td>42001</td><td>Network timeout — please check your internet connection and try again.</td></tr><tr><td>42002</td><td>Authorization error — verify your authentication method.</td></tr><tr><td>42003</td><td>Network issue detected — please reconnect and try again.</td></tr><tr><td>42004</td><td>The operation failed due to insufficient memory.</td></tr><tr><td>42005</td><td>Internet connection error — please check your network settings.</td></tr><tr><td>42006</td><td>Connection lost — please ensure you are connected to the internet.</td></tr><tr><td>42008</td><td>HTTP 401 — Unauthorized access.</td></tr><tr><td>42009</td><td>HTTP 403 — Forbidden request.</td></tr><tr><td>42010</td><td>HTTP 404 — Requested resource not found.</td></tr><tr><td>42011</td><td>HTTP 500 — Internal server error.</td></tr><tr><td>42012</td><td>HTTP 4XX — Client-side request error.</td></tr><tr><td>42013</td><td>HTTP 5XX — Server-side processing error.</td></tr><tr><td>52001</td><td>Null response received from server.</td></tr><tr><td>52003</td><td>Failed to parse server response.</td></tr><tr><td>52004</td><td>Invalid input parameters detected.</td></tr><tr><td>52005</td><td>Detection process timed out.</td></tr><tr><td>52006</td><td>Error while parsing network response.</td></tr><tr><td>52007</td><td>Unexpected error occurred — please try again later.</td></tr><tr><td>52008</td><td>KYC SDK not initialized — please initialize before proceeding.</td></tr><tr><td>52009</td><td>The KYC SDK process is already running.</td></tr><tr><td>72001</td><td>The user canceled the process by pressing the back button.</td></tr><tr><td>72002</td><td>Failed to start camera — please retry.</td></tr><tr><td>72003</td><td>Backend response contains error</td></tr><tr><td>72005</td><td>Camera permission missing — enable camera access to proceed.</td></tr><tr><td>72006</td><td>Maximum retry attempts reached.</td></tr><tr><td>72007</td><td>Card detection failed — please retake the image.</td></tr><tr><td>72008</td><td>Potential threat or anomaly detected.</td></tr><tr><td>72009</td><td>The user postponed the process by selecting “Try Later.”</td></tr><tr><td>72010</td><td>Detection process canceled.</td></tr><tr><td>52010</td><td>Internal data inconsistency</td></tr></tbody></table>

### VIDA Backend Error <a href="#sdk-errors" id="sdk-errors"></a>

<table data-header-hidden><thead><tr><th width="195.76519775390625">Value</th><th>Description</th></tr></thead><tbody><tr><td><strong>Value</strong></td><td><strong>Description</strong></td></tr><tr><td>5014</td><td>Image Quality is too low, Kindly ensure the image is well lit and is placed in the right angle</td></tr><tr><td>5016</td><td>Invalid card, Kindly ensure the image is well lit and is placed in the right angle</td></tr><tr><td>5020</td><td>No card detected</td></tr><tr><td>5023</td><td>Bad Quality Image , Id Number Extraction Failed</td></tr><tr><td>5025</td><td>The card failed the idVerification</td></tr><tr><td>5026</td><td>Extraction failed for the below ocr field. Please make sure the fields are properly visible on the card.</td></tr><tr><td>5101</td><td>No card detected</td></tr><tr><td>5103</td><td>Bad Quality Image, Portrait Extraction Failed</td></tr><tr><td>5104</td><td>Minimum OCR fields did not meet the score threshold</td></tr><tr><td>5201</td><td>No portrait is present on the card</td></tr><tr><td>5202</td><td>Image Quality check failed as image is too blurry</td></tr><tr><td>5203</td><td>Image of the card is too dark</td></tr><tr><td>5204</td><td>Image of the card is too bright</td></tr><tr><td>5205</td><td>Image of card is too small, try taking a closer image</td></tr><tr><td>5206</td><td>No PROVINSI title is present, make sure all card’s edge is present within the image</td></tr><tr><td>5301</td><td>Card resolution is smaller than (400x300), the recommended image size is (800x600)</td></tr><tr><td>5302</td><td>Card resolution is larger than (4000x3000), the recommended image size is (800x600)</td></tr><tr><td>5303</td><td>Image size is larger than max allowed 3MB</td></tr><tr><td>5401</td><td><p>Orientation unknown, take image of card on a flat surface in upright position</p><p><br></p></td></tr></tbody></table>

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.

### Generic Error Code for MyKad, NonMyKas, Passport, & KTP cards

<table><thead><tr><th width="117.18707275390625">Error Code</th><th width="161.6009521484375">HTTP Error Code</th><th>Error Message</th></tr></thead><tbody><tr><td>5000</td><td>200</td><td>Success</td></tr><tr><td>5001</td><td>400</td><td>Missing required field</td></tr><tr><td>5002</td><td>400</td><td>Unable to decode string.</td></tr><tr><td>5003</td><td>400</td><td>Invalid request parameter or Missing request parameter.</td></tr><tr><td>5005</td><td>500</td><td>Internal server error</td></tr><tr><td>5006</td><td>400</td><td>Unsupported image format detected.</td></tr><tr><td>5007</td><td>400</td><td>Score is below threshold</td></tr><tr><td>5008</td><td>500</td><td>Data processing error</td></tr><tr><td>5009</td><td>400</td><td>Wrong input format</td></tr><tr><td>5010</td><td>400</td><td>Invalid Image Specification</td></tr><tr><td>5016</td><td>400</td><td>Invalid card, Kindly ensure the image is well lit and is placed in the right angle</td></tr><tr><td>5020</td><td>400</td><td>No card detected</td></tr><tr><td>5022</td><td>500</td><td>Internal server error while fetching the details.</td></tr><tr><td>5024</td><td>400</td><td>The given card is forged</td></tr><tr><td>5027</td><td>400</td><td>The ID numbers on the front and back of your card do not match. Please upload both sides of the same card</td></tr><tr><td>5028</td><td>400</td><td>The card appears to be spoofed</td></tr><tr><td>5103</td><td>400</td><td>Bad Quality Image , Portrait Extraction Failed</td></tr><tr><td>5207</td><td>400</td><td>Quality check failed. Card has glare, try taking image in a different angle</td></tr><tr><td>5321</td><td>400</td><td>Card resolution for back side is smaller than (275 x 176), the recommended image size is (800x600)</td></tr><tr><td>5322</td><td>400</td><td>Card back side verification is not supported on V1 endpoint, please switch to V2</td></tr><tr><td>5323</td><td>400</td><td>Configuration set for front only verification, please send only front side image or contact VIDA Support</td></tr><tr><td>5324</td><td>400</td><td>Configuration set for both side verification, please send both front and back side image or contact VIDA Support</td></tr><tr><td>5402</td><td>400</td><td>Front side and back side of the card have different card types, please send the same card type for verification.</td></tr><tr><td>5403</td><td>400</td><td>The card type sent is not supported for backside verification</td></tr><tr><td>5501</td><td>400</td><td>[OSS] Product id not found</td></tr><tr><td>5502</td><td>400</td><td>[OSS] Product credentials not found</td></tr><tr><td>5503</td><td>400</td><td>[OSS] Product expired</td></tr><tr><td>5504</td><td>400</td><td>[OSS] Invalid License</td></tr><tr><td>5505</td><td>400</td><td>Invalid product</td></tr><tr><td>5601</td><td>400</td><td>Spoof check failed. Image submitted is Recaptured</td></tr><tr><td>5602</td><td>400</td><td>Spoof check failed. Image submitted is either B&#x26;W or Photocopy</td></tr><tr><td>5603</td><td>400</td><td>Spoof check failed. Image submitted is color reprint</td></tr><tr><td>5604</td><td>400</td><td>Spoof check failed. Image submitted is screenshot</td></tr><tr><td>5611</td><td>400</td><td>Minimum landmark checks did not meet the score threshold</td></tr></tbody></table>

### Generic Code for KTP cards

<table><thead><tr><th width="116.865234375">Error Code</th><th width="162.393798828125">HTTP Error Code</th><th>Error Message</th></tr></thead><tbody><tr><td>5201</td><td>400</td><td>No portrait is present on the card</td></tr><tr><td>5202</td><td>400</td><td>Image Quality check failed as image is too blurry</td></tr><tr><td>5203</td><td>400</td><td>Image of the card is too dark</td></tr><tr><td>5204</td><td>400</td><td>Image of the card is too bright</td></tr><tr><td>5205</td><td>400</td><td>Image of card is too small, try taking a closer image</td></tr><tr><td>5206</td><td>400</td><td>No PROVINSI title is present, make sure all card’s edge is present within the image</td></tr><tr><td>5301</td><td>400</td><td>Card resolution is smaller than (400×300), the recommended image size is (800×600))</td></tr><tr><td>5302</td><td>400</td><td>Card resolution is larger than (4000×3000), the recommended image size is (800×600))</td></tr><tr><td>5303</td><td>400</td><td>Image size is larger than max allowed 3MB</td></tr><tr><td>5401</td><td>400</td><td>Orientation unknown, take image of card on a flat surface in upright position</td></tr><tr><td>5005</td><td>500</td><td>Extraction_failed</td></tr><tr><td>5025</td><td>400</td><td>The card failed the idVerification</td></tr><tr><td>5026</td><td>400</td><td>Extraction failed for the below ocr field. Please make sure the fields are properly visible on the card.</td></tr><tr><td>5023</td><td>400</td><td>Bad Quality Image , Id Number Extraction Failed</td></tr><tr><td>5101</td><td>400</td><td>No card detected</td></tr><tr><td>5102</td><td>500</td><td>Error processing input/output</td></tr><tr><td>5103</td><td>400</td><td>Bad Quality Image, Portrait Extraction Failed</td></tr><tr><td>5104</td><td>400</td><td>Minimum OCR fields did not meet the score thresholds</td></tr><tr><td>10024</td><td>200</td><td>Image submitted is blurred</td></tr><tr><td>10025</td><td>200</td><td>Image submitted has glare</td></tr><tr><td>10026</td><td>200</td><td>Image submitted is too dark to process</td></tr><tr><td>10027</td><td>200</td><td>Input card image is too small in resolution to process. min resolution : [275 * 176]</td></tr></tbody></table>

### OCR warning code for Malaysian cards & NonKTP cards

<table><thead><tr><th width="117.08843994140625">Error Code</th><th width="161.5225830078125">HTTP Error Code</th><th>Error Message</th></tr></thead><tbody><tr><td>10028</td><td>200</td><td>Low confidence score for ocr, please check [name] from ocrResult for more details</td></tr><tr><td>10029</td><td>200</td><td>Low confidence score for ocr, please check [address] from ocrResult for more details</td></tr><tr><td>10030</td><td>200</td><td>Low confidence score for ocr, please check [citizenship] from ocrResult for more details</td></tr><tr><td>10031</td><td>200</td><td>Low confidence score for ocr, please check [dob] from ocrResult for more details</td></tr><tr><td>10032</td><td>200</td><td>Low confidence score for ocr, please check [gender] from ocrResult for more details</td></tr><tr><td>10033</td><td>200</td><td>Low confidence score for ocr, please check [idNumber] from ocrResult for more details</td></tr><tr><td>10034</td><td>200</td><td>Low confidence score for ocr, please check [religion] from ocrResult for more details</td></tr><tr><td>10119</td><td>200</td><td>Low confidence score for ocr, please check [personalIdNumber] from ocrResult for more details</td></tr><tr><td>10120</td><td>200</td><td>Low confidence score for ocr, please check [dateOfExpiry] from ocrResult for more details</td></tr><tr><td>10121</td><td>200</td><td>Low confidence score for ocr, please check [dateOfIssuance] from ocrResult for more details</td></tr><tr><td>10122</td><td>200</td><td>Low confidence score for ocr, please check [issuerName] from ocrResult for more details</td></tr><tr><td>10123</td><td>200</td><td>Low confidence score for ocr, please check [issuerCountry] from ocrResult for more details</td></tr><tr><td>10124</td><td>200</td><td>Low confidence score for ocr, please check [issuingAuthority] from ocrResult for more details</td></tr><tr><td>10125</td><td>200</td><td>Low confidence score for ocr, please check [militaryId] from ocrResult for more details</td></tr><tr><td>10126</td><td>200</td><td>Low confidence score for ocr, please check [militaryRank] from ocrResult for more details</td></tr><tr><td>10127</td><td>200</td><td>Low confidence score for ocr, please check [militaryDivision] from ocrResult for more details</td></tr><tr><td>10128</td><td>200</td><td>Low confidence score for ocr, please check extendedIdNumber from for more details</td></tr><tr><td>10129</td><td>200</td><td>Low confidence score for ocr, please check countryOfOrigin from for more details</td></tr></tbody></table>

### Landmark codes for Malaysian cards

<table><thead><tr><th width="116.6697998046875">Error Code</th><th width="165.63824462890625">HTTP Status Code</th><th>Error Message</th></tr></thead><tbody><tr><td>10012</td><td>200</td><td>Image has Occlusion [kad_pengenalan_header], please check landmark details for more details</td></tr><tr><td>10013</td><td>200</td><td>Image has Occlusion [card_logo], please check landmark details for more details</td></tr><tr><td>10014</td><td>200</td><td>Image has Occlusion [hibiscus], please check landmark details for more details</td></tr><tr><td>10015</td><td>200</td><td>Image has Occlusion [microchip], please check landmark details for more details</td></tr><tr><td>10017</td><td>200</td><td>Image has Occlusion [msg_logo], please check landmark details for more details</td></tr><tr><td>10018</td><td>200</td><td>Image has Occlusion [my_flag], please check landmark details for more details</td></tr><tr><td>10020</td><td>200</td><td>Image has Occlusion [ghost], please check landmark details for more details</td></tr><tr><td>10021</td><td>200</td><td>Image has Occlusion [portrait], please check landmark details for more details</td></tr><tr><td>10022</td><td>200</td><td>Image has Occlusion [name], please check landmark details for more details</td></tr><tr><td>10023</td><td>200</td><td>Image has Occlusion [id_number], please check landmark details for more details</td></tr><tr><td>10401</td><td>200</td><td>Landmark verification failed for the provided card image.</td></tr><tr><td>10426</td><td>200</td><td>Image has Occlusion, please check coat_of_arm from for more details</td></tr><tr><td>10427</td><td>200</td><td>Image has Occlusion, please check kopiah from for more details</td></tr><tr><td>10428</td><td>200</td><td>Image has Occlusion, please check twin_tower from for more details</td></tr><tr><td>10429</td><td>200</td><td>Image has Occlusion, please check state_registrar from for more details</td></tr><tr><td>10430</td><td>200</td><td>Image has Occlusion, please check sn from for more details</td></tr><tr><td>10431</td><td>200</td><td>Image has Occlusion, please check my_logo from for more details</td></tr><tr><td>10432</td><td>200</td><td>Image has Occlusion, please check negara_asal from for more details</td></tr><tr><td>10433</td><td>200</td><td>Image has Occlusion, please check military_logo from for more details</td></tr></tbody></table>