> 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/liveness/integration/api.md).

# API

## Liveness API Versions

VIDA's Liveness Get Result API is available in two versions: **v2** and **v3**. Both are fully supported.

### Quick comparison

|                                   | v2                                                     | v3                                                |
| --------------------------------- | ------------------------------------------------------ | ------------------------------------------------- |
| Basic/Active Liveness `scoreName` | `LIVENESS`, `IMAGE_MANIPULATION`                       | `LIVENESS`, `IMAGE_MANIPULATION`                  |
| Smart Liveness `scoreName`        | `passiveLiveness`, `colorCaptcha`, `imageManipulation` | `LIVENESS`, `COLOR_CAPTCHA`, `IMAGE_MANIPULATION` |
| Reads historical v2 transactions  | Yes                                                    | Yes, automatically translated to canonical names  |