> 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/ine.md).

# INE Service

**Facephi INE Service** It is a REST API service in C++ that allows performing Identity Verification through Facial Recognition. The service is based on the SelphID SDK, technology developed by FacePhi. It implements the Mexipay-INE (National Electoral Institute) specification of Mexico.

The service exposes the following endpoints:

* `POST /api/v1/facial/authentication`
* `GET /api/v1/health`
* `GET /api/v1/version`

The supported image formats are:

* INE (0)
* JPEG (1)
* TEMPLATE RAW (2)
* BEST IMAGE Token (3)

The main distribution of the service is a Docker container based on Ubuntu 26.04.

### JWT authentication

JWT authentication is optional and disabled by default.

* It is configured when the service starts in `config.json` with `auth_enabled`, `auth_jwt_secret`, `auth_accept_authorization_header`, `auth_accept_api_key_header` and `auth_api_key_header_name`.
* The same values can be overridden with the environment variables `FACEPHI_INE_REST_AUTH_*`.
* `GET /api/v1/health` and `GET /api/v1/version` remain public.
* `POST /api/v1/facial/authentication` requires a valid JWT when authentication is enabled.
* The service does not expose endpoints `GET/POST /config` at runtime, so JWT configuration can only be set at startup.