> 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.1.0_release_notes.md).

# 2.1.0

**Release date:** June 11, 2026

## Overview

Facephi Finger Service 2.1.0 adds the operational metrics endpoint used to report fingerprint usage counters.

This version provides:

* Public fingerprint extraction and 1:1 authentication endpoints under the Facephi contract
* Usage counter report via `GET /api/v1/finger/metrics`
* Explicit documentation of the supported fingerprint image formats for image-based requests: `WSQ`, `bmp`, `png`, `jpg`, `jp2`

## 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/metrics`      | GET      | Reports fingerprint usage counters                     |
| `/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

* Customers that need operational visibility can start consuming the endpoint `/metrics`.
* Continue relying only on the documented public fields; internal processing details remain abstracted.

## Deployment

```bash
docker pull facephicorp.jfrog.io/docker-pro-fphi/facephi-finger-service:2.1.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.1.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 fully applied (`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)
* [Change Log](/docs.facephi-en/sdks/backend-sdk/finger/changelog.md)

## Support

For Technical Support, contact your Facephi representative.