> For the complete documentation index, see [llms.txt](https://valify.gitbook.io/valify-ios-sdk-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://valify.gitbook.io/valify-ios-sdk-documentation/error-codes/sdk-error-codes.md).

# SDK Error Codes

### General Error Codes

| Error Code | Type            | Description                                   | Suggested Action                                                                   |
| ---------- | --------------- | --------------------------------------------- | ---------------------------------------------------------------------------------- |
| 6001       | Builder Error   | Access token field is empty                   | Please make sure to specify your access token                                      |
| 6002       | Builder Error   | Bundle key field is empty                     | Please make sure to add a bundle key to the builder configurations                 |
| 6003       | Builder Error   | Base Url field is empty                       | Please make sure to add the base URL to the builder configurations                 |
| 6004       | Builder Error   | Invalid Language entered                      | Please make sure to specify your language. Use "en" for English or "ar" for Arabic |
| 7000       | Builder Error   | Base URL, access token, or bundle key missing | Please make sure all required builder configurations are provided                  |
| 7001       | Service Failure | Network connection issue                      | Please make sure you have internet access                                          |
| 7002       | Service Failure | Server error                                  | If the error persists, please contact us                                           |
| 7003       | Service Failure | Security error                                | Please make sure you are not using a rooted device                                 |
| 7004       | Service Failure | Unauthorized                                  | Generate a new access token and try again                                          |
| 7005       | Service Failure | Server error                                  | If the error persists, please contact us                                           |
| 7006       | Service Failure | Camera access denied                          | Please allow camera permission                                                     |
| 7007       | Service Failure | Trials exceeded                               | Please generate a new access token to start a new session                          |
| 7008       | Service Failure | Quota expired                                 | Please recharge your quota and try again                                           |
| 7009       | Service Failure | Invalid SSL certificate                       | Please make sure SSL certificate is valid                                          |
| 7010       | Service Failure | Invalid access token                          | Please make sure you have a valid access token                                     |
| 7011       | Service Failure | Server not found                              | Please make sure the baseURL is correct                                            |
| 7012       | Service Failure | Server error                                  | If the error persists, please contact us                                           |
| 7013       | Service Failure | Location access denied                        | Please allow location permission                                                   |
| 7014       | Service Failure | Encryption issue detected                     | If the error persists, please contact us                                           |
| 7015       | Service Failure | Decryption issue detected                     | If the error persists, please contact us                                           |

### Document Capture Error Codes

| Error Code | Type            | Description                                                      | Suggested Action                                                     |
| ---------- | --------------- | ---------------------------------------------------------------- | -------------------------------------------------------------------- |
| 6005       | Builder Error   | You cannot use capture-only mode with document verification      | Please make sure you are only using only one of those configurations |
| 6006       | Builder Error   | You cannot use preview capture images with document verification | Please make sure you are only using only one of those configurations |
| 7101       | Service Failure | Data extraction failed                                           | Please make sure that the ID is clear                                |
| 7102       | Service Failure | Document verification failed                                     | Please make sure that you are using a real ID                        |
| 7103       | Service Failure | Data validation failed                                           | Please make sure that you are using a valid ID                       |

### Biometrics Error Codes

| Error Code | Type            | Description                              | Suggested Action                                               |
| ---------- | --------------- | ---------------------------------------- | -------------------------------------------------------------- |
| 6212       | Builder Error   | Minimum Liveness actions count not met   | Please make sure you have at least one action                  |
| 6214       | Builder Error   | Minimum Liveness instructions not met    | Please make sure number of instructions is at least one        |
| 6215       | Builder Error   | Number of instructions exceeded          | Please make sure number of instructions don't exceed ten       |
| 6216       | Builder Error   | Minimum action time not met              | Please make sure time per action is at least five seconds      |
| 6217       | Builder Error   | Maximum action time exceeded             | Please make sure time per action doesn't exceed thirty seconds |
| 6218       | Builder Error   | Maximum number of failed trials exceeded | Please make sure the number of failed trials is at least two   |
| 6224       | Builder Error   | Minimum number of actions not met        | Please make sure to choose at least 2 liveness actions         |
| 6225       | Builder Error   | Invalid transaction Id                   | Please make sure to specify a valid transaction ID             |
| 6226       | Builder Error   | Invalid facematch image data             | Please make sure a valid facematch image is provided           |
| 7201       | Service Failure | Face is not similar                      | Please make sure that the user matches the face in the image   |
| 7202       | Service Failure | Face not detected                        | Please make sure that there is a face in the Liveness frame    |
| 7203       | Service Failure | Face is not live                         | Please make sure you are using a real face and not an image    |
| 7204       | Service Failure | Missing or invalid configuration         | Please make sure a valid configuration is provided at start    |

### DocKit Error Codes

| Error Code | Type            | Description                             | Suggested Action                                                  |
| ---------- | --------------- | --------------------------------------- | ----------------------------------------------------------------- |
| 7016       | Service Failure | Camera permission not granted           | Please allow camera permission                                    |
| 7017       | Service Failure | NFC data does not match MRZ             | Please make sure the correct document is scanned                  |
| 7018       | Service Failure | Document validation failed              | Please make sure the document meets the required validation rules |
| 7020       | Service Failure | Unknown SDK error                       | If the error persists, please contact us                          |
| 7050       | Service Failure | Camera failed to start                  | Please make sure camera access is available and try again         |
| 8102       | Builder Error   | Builder configuration validation failed | Please review the builder configuration fields                    |
| 9100       | Service Failure | Unknown error code returned             | If the error persists, please contact us                          |

### Auth Error Codes

| Error Code | Type            | Description                                         | Suggested Action                                                                                    |
| ---------- | --------------- | --------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| 7101       | Builder Error   | Base URL is missing                                 | Please make sure to add the base URL to the builder configurations                                  |
| 7102       | Builder Error   | Language is missing or invalid                      | Please make sure to specify your language. Use "en" for English or "ar" for Arabic                  |
| 7103       | Builder Error   | Bundle key is missing                               | Please make sure to add a bundle key to the builder configurations                                  |
| 7104       | Builder Error   | Client assertion missing                            | Please provide a client assertion for federated login                                               |
| 7105       | Builder Error   | User reference Id missing                           | Please make sure to provide a valid user reference Id                                               |
| 7106       | Builder Error   | Code verifier missing                               | Please provide a code verifier when using authorization code                                        |
| 7107       | Builder Error   | Invalid or conflicting authentication configuration | Please make sure only one authentication method is configured, and that a service/flow is specified |
| 7201       | Service Failure | Location permission denied                          | Please allow location permission                                                                    |
| 7202       | Service Failure | Location services disabled                          | Please enable location services on the device                                                       |
| 7203       | Service Failure | Failed to retrieve location                         | Please try again with location services enabled                                                     |
| 7204       | Service Failure | Failed to retrieve user information                 | If the error persists, please contact us                                                            |
| 7205       | Service Failure | Invalid phone number                                | Please make sure a valid phone number is provided                                                   |
| 7301       | Service Failure | Failed to load security questions                   | If the error persists, please contact us                                                            |
| 7401       | Service Failure | Orchestrator configuration missing                  | Please make sure a valid session configuration is provided                                          |
| 7402       | Builder Error   | Orchestrator builder error                          | Please review the orchestrator configuration fields                                                 |
| 7501       | Service Failure | Document verification failed                        | Please make sure that you are using a real ID                                                       |
| 7502       | Service Failure | Document verification cancelled                     | Please retry document verification                                                                  |
| 7601       | Service Failure | CSO check failed                                    | If the error persists, please contact us                                                            |
| 7602       | Service Failure | NTRA data mismatch                                  | Please make sure the entered information matches your official records                              |
| 7603       | Service Failure | NTRA check failed                                   | If the error persists, please contact us                                                            |
| 7701       | Service Failure | Contract rejected                                   | Please review and accept the contract to continue                                                   |
| 7702       | Service Failure | Contract failed                                     | If the error persists, please contact us                                                            |
| 7801       | Builder Error   | OTP configuration error                             | Please review the OTP builder configuration                                                         |
| 7802       | Service Failure | OTP verification failed                             | Please make sure the correct code was entered and try again                                         |
| 7803       | Service Failure | OTP cancelled                                       | Please retry the OTP step                                                                           |
| 7901       | Service Failure | Email update failed                                 | If the error persists, please contact us                                                            |
| 7902       | Service Failure | Phone update failed                                 | If the error persists, please contact us                                                            |
| 7999       | Service Failure | Unknown error                                       | If the error persists, please contact us                                                            |

### OTP Error Codes

| Error Code | Type            | Description                    | Suggested Action                                            |
| ---------- | --------------- | ------------------------------ | ----------------------------------------------------------- |
| 7020       | Service Failure | No services configured         | Please make sure at least one service is specified          |
| 7021       | Service Failure | Invalid services configuration | Please review the services configuration                    |
| 7022       | Builder Error   | Invalid configuration          | Please review the OTP builder configuration                 |
| 8107       | Service Failure | OTP verification failed        | Please make sure the correct code was entered and try again |
| 8110       | Service Failure | Session failed to start        | If the error persists, please contact us                    |
