# Error Codes

### Consolidated Error Code List

This section defines the standardised error codes across all face authentication and capture flows.

### ✅ 0–99: Success & Match Status

| Code | Message                                       |
| ---- | --------------------------------------------- |
| 000  | Image capture or match performed successfully |
| 001  | Face match failed                             |

### 🔍 100–199: Request Validation / Input Errors

| Code | Message                                                                                         |
| ---- | ----------------------------------------------------------------------------------------------- |
| 100  | Invalid request input (PidOptions/XML). Should strictly adhere to spec                          |
| 101  | `txn` not present                                                                               |
| 102  | Duplicate transaction ID                                                                        |
| 103  | Please install the correct app                                                                  |
| 110  | Signed profile document has expired. Please refresh your profile to perform face authentication |
| 111  | Invalid AUA Code                                                                                |
| 112  | Invalid subAUA Code                                                                             |
| 113  | Invalid intent Code                                                                             |
| 114  | Invalid langauge Code                                                                           |
| 150  | Invalid hint. No matching profile available                                                     |
| 160  | Invalid value for timeout                                                                       |
| 161  | Time expired request                                                                            |
| 190  | Invalid value for pidFormat                                                                     |
| 191  | Unable to interpret the QR Code                                                                 |
| 192  | Unauthorised callback domain (reserved)                                                         |
| 193  | Invalid issuer of the JWT. Please check `iss` value                                             |
| 194  | Duplicate face capture request                                                                  |
| 195  | Invalid app id                                                                                  |
| 196  | Verification failed. Invalid app signature                                                      |
| 197  | Invalid audience of the JWT. Please check `aud` value                                           |

### 📦 200–299: Protocol / Format Handling

| Code | Message                           |
| ---- | --------------------------------- |
| 200  | Invalid Demo structure (Reserved) |
| 210  | Protobuf format not supported     |

### 📸 730–739: Capture Flow Errors

| Code | Message                                                |
| ---- | ------------------------------------------------------ |
| 730  | Capture failed. Please improve lighting                |
| 731  | User abort                                             |
| 732  | Capture failed. Please move to better lighting         |
| 733  | Capture failed. Please improve lighting and hold still |
| 734  | Capture failed. Please check background                |
| 736  | Capture failed. Please blink during capture            |
| 738  | Capture failed. Please focus towards the camera        |

### 📱 800–859: Credential Share Errors

| Code | Message                    |
| ---- | -------------------------- |
| 801  | Invalid Credential request |
| 802  | Unauthorised claim request |
| 803  | Invalid claim request      |

### 📱 850–899: Application Environment / Policy Enforcement

| Code    | Message                                                      |
| ------- | ------------------------------------------------------------ |
| 850     | Unsupported application version. Please upgrade              |
| 860     | Application seems to be corrupted. Please reinstall          |
| 861     | Please lock your bootloader                                  |
| 862     | Please restore to factory ROM                                |
| 863     | Please lock your bootloader and restore to factory ROM       |
| 864     | Please retry after {n} hrs                                   |
| 870–879 | Application not allowed on this device – `{xxx}`             |
| 880     | Application not allowed. Please upgrade Google Play Services |
| 881     | Unsupported Android version. Please upgrade                  |
| 890     | Application blocked due to low resources                     |
| 891     | Not supported below Android 8                                |
| 892     | USB Debugging enabled — application blocked                  |

### ⚙️ 900–909: Runtime and Network Issues

| Code | Message                                                                                       |
| ---- | --------------------------------------------------------------------------------------------- |
| 901  | Resource out of memory                                                                        |
| 902  | Device not connected to internet                                                              |
| 903  | Failed to connect to server (Timed out)                                                       |
| 904  | Failed due to network-related issues                                                          |
| 905  | Callback failed. HTTP {status}. {reason}. Please check with verifier app/portal administrator |

### 🖼️ 9700–9999: Device/SDK Capture Failures

| Code Range   | Message                                                            |
| ------------ | ------------------------------------------------------------------ |
| 9601 to 9699 | “Error in performing Online FaceAuth - {AUTH API 2.5 Error Codes}" |
| 9701 to 9799 | “Failed to capture image - {xxxx}"                                 |
| 9801 to 9899 | “Failed to capture image - {xxxx}"                                 |
| 9901 to 9999 | “Failed to capture image - {xxxx}"                                 |

### 🔖 Notes


---

# 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://docs.uidai.gov.in/readme/app-to-app-credential-flows/uidai-specifications/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.