> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-sdk/ios/standalone-modules/caffacelivenesslite/result-reference.md).

# Result Reference

Quick links: [Overview](/caf-sdk/ios/standalone-modules/caffacelivenesslite.md) | [Building the SDK](/caf-sdk/ios/standalone-modules/caffacelivenesslite/builder.md) | [Start Liveness Verification](/caf-sdk/ios/standalone-modules/caffacelivenesslite/start-sdk.md) | [UI Customization](/caf-sdk/ios/standalone-modules/caffacelivenesslite/ui-customization.md) | [Installation](/caf-sdk/ios/standalone-modules/caffacelivenesslite/installation.md) | [Current Version](/caf-sdk/ios/standalone-modules/caffacelivenesslite/current-version.md) | [Requirements](/caf-sdk/ios/standalone-modules/caffacelivenesslite/requirements.md) | [Source Code](/caf-sdk/ios/standalone-modules/caffacelivenesslite/source-code.md) | [Result Reference](/caf-sdk/ios/standalone-modules/caffacelivenesslite/result-reference.md) | [Release Notes](/caf-sdk/ios/standalone-modules/caffacelivenesslite/release-notes.md) | [FAQ](/caf-sdk/ios/standalone-modules/caffacelivenesslite/faq_caf_face_liveness_sdk.md)

### CafFaceLivenessLiteResult – Success Event

| Field            | Description                                                                                                  |
| ---------------- | ------------------------------------------------------------------------------------------------------------ |
| `signedResponse` | Opaque JWT returned by async route. Forward it to your backend; the SDK does not return `isAlive` or images. |

{% hint style="info" %}
From **2.0.0**, a successful capture starts an async transaction. Use `signedResponse` with your backend to obtain the final liveness outcome.
{% endhint %}

### CafErrorType – Error Handling

Common error types returned via `didFinishWithError(type:description:)`:

| Error                           | Description                                                                                                    |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| `unsupportedDevice`             | Device does not meet minimum HW/SW requirements                                                                |
| `cameraPermission`              | Camera permission not granted                                                                                  |
| `networkException`              | Network-related error (no internet, timeout, etc.)                                                             |
| `serverException`               | Server-side processing error                                                                                   |
| `tokenException`                | Invalid or expired token                                                                                       |
| `captureAlreadyActiveException` | A previous capture is still active                                                                             |
| `userTimeoutException`          | User did not complete the capture in time                                                                      |
| `imageNotFoundException`        | Capture image not found                                                                                        |
| `tooManyRequestsException`      | Rate limiting / too many requests                                                                              |
| `invalidResponseException`      | Invalid or malformed server response                                                                           |
| `permissionException`           | Generic OS permission error                                                                                    |
| `libraryException`              | Underlying library failure                                                                                     |
| `unexpectedErrorException`      | Unexpected internal error                                                                                      |
| `unknownException`              | Unspecified error                                                                                              |
| `cameraException`               | Camera hardware error                                                                                          |
| `certificateException`          | Certificate validation failed                                                                                  |
| `invalidOptionsException`       | Invalid SDK configuration options provided                                                                     |
| `securityException`             | Security violation detected (triggered when `enableSecurity: true` and instrumentation or hooking is detected) |

### CafFailureType – Failure References

Available feedback codes returned via `didFinishWithFailure(type:description:signedResponse:)`:

| Enum value        | Localized description (English)                                                            | GPA | LA |
| ----------------- | ------------------------------------------------------------------------------------------ | --- | -- |
| `unknown`         | Try again                                                                                  | ✅   | ❌  |
| `tooMuchMovement` | Keep still                                                                                 | ✅   | ❌  |
| `tooBright`       | Move somewhere darker                                                                      | ✅   | ❌  |
| `tooDark`         | Move somewhere brighter                                                                    | ✅   | ❌  |
| `misalignedFace`  | Keep your face in the oval                                                                 | ✅   | ❌  |
| `faceTooFar`      | Move your face closer to the screen                                                        | ✅   | ❌  |
| `faceTooClose`    | Move your face farther from the screen                                                     | ✅   | ❌  |
| `sunglasses`      | Remove sunglasses                                                                          | ✅   | ❌  |
| `systemError`     | System Error                                                                               | ⚠️  | ✅  |
| `rejected`        | Transaction could not be completed                                                         | ⚠️  | ✅  |
| `faceNotFound`    | Align your face in the oval and then try to keep still                                     | ⚠️  | ✅  |
| `obscuredFace`    | Make sure your whole face is visible and remove any accessories that might cover your face | ✅   | ✅  |
| `timeout`         | System timeout                                                                             | ⚠️  | ✅  |
| `eyewear`         | Remove your eyewear                                                                        | ⚠️  | ✅  |
| `multipleFaces`   | Ensure only one person is visible                                                          | ✅   | ✅  |
| `eyesClosed`      | Make sure your eyes are open                                                               | ✅   | ✅  |
| `userNotFound`    | Transaction could not be completed                                                         | ⚠️  | ✅  |
| `lightingIssues`  | Make sure your face is well lit and free from glare                                        | ⚠️  | ✅  |
| `framesBlurry`    | Align your face in the oval and then try to keep still                                     | ⚠️  | ✅  |
| `deviceIssue`     | Try a different device                                                                     | ⚠️  | ✅  |
| `motionIssue`     | Align your face in the oval and then try to keep still                                     | ⚠️  | ✅  |
| `backgroundIssue` | Move to a different location with a neutral background                                     | ⚠️  | ✅  |
| `deviceRestart`   | Please restart your device and try again                                                   | ⚠️  | ✅  |
| `processingFault` | Please try again                                                                           | ⚠️  | ✅  |

Key: ✅ = will be returned, ❌ = will not be returned, ⚠️ = may be returned in the future


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.caf.io/caf-sdk/ios/standalone-modules/caffacelivenesslite/result-reference.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.