> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-en/sdks/backend-sdk/finger/release_notes/2.0.0_release_notes.md).

# 2.0.0

**Release date:** June 8, 2026

## Overview

Facephi Finger Service 2.0.0 introduces the public Facephi contract for Fingerprint extraction and 1:1 authentication.

This Version provides:

* Public Fingerprint operation endpoints based on contract 2.0.0
* Removal of legacy 1.x.x public routes
* Stricter request validation for Fingerprint operations
* Supported image formats for image-based Fingerprint requests: `wsq`, `bmp`, `png`, `jpg`, `jp2`

## Breaking Changes

* `POST /api/v1/finger/create-template` has been replaced by `POST /api/v1/finger/extract`.
* `POST /api/v1/finger/verify` has been replaced by `POST /api/v1/finger/authenticate`.
* Fingerprint operation payloads are not compatible with 1.x.x clients.

## Included endpoints

| Endpoint                      | Method   | Purpose                                                |
| ----------------------------- | -------- | ------------------------------------------------------ |
| `/api/v1/finger/extract`      | POST     | Generates a Fingerprint template from a public payload |
| `/api/v1/finger/authenticate` | POST     | Executes Fingerprint 1:1 authentication                |
| `/api/v1/finger/version`      | GET      | Service version and license status                     |
| `/api/v1/finger/health`       | GET      | Service health and availability                        |
| `/api/v1/finger/config`       | GET/POST | Gets or updates the runtime configuration              |

## Migration notes

* Update client integrations to use `/extract` and `/authenticate`.
* Update request payloads to the public field names of Version 2.0.0.
* Remove any dependency on legacy fields or the availability of legacy routes.

## Deployment

```bash
docker pull facephicorp.jfrog.io/docker-pro-fphi/facephi-finger-service:2.0.0

docker run -d \
  -p 6982:6982 \
  -v /path/to/license:/app/license \
  -v /path/to/config:/app/config \
  --name finger-service \
  facephicorp.jfrog.io/docker-pro-fphi/facephi-finger-service:2.0.0
```

## Requirements

| Component        | Requirement                |
| ---------------- | -------------------------- |
| Operating system | Linux x86\_64              |
| License          | Valid Facephi license file |
| Docker           | Recommended for deployment |

## Known limitations

* Fingerprint operation endpoints are only available when the service runs in the role `master`.
* Dynamic configuration updates are applied in memory and are not persisted automatically.
* Some configuration values require a restart to be applied fully (`port`, `number_of_threads`).

## Documentation

* [Installation guide](/docs.facephi-en/sdks/backend-sdk/finger/installation/installation_instructions.md)
* [Technical specifications](/docs.facephi-en/sdks/backend-sdk/finger/technical_documentation/technical_specifications.md)
* [Changelog](/docs.facephi-en/sdks/backend-sdk/finger/changelog.md)

## Support

For Technical Support, contact your Facephi representative.