DEVELOPERS · CheckID · API 1.2.260123

Biometric Identification Groups

Manage 1:N identification groups for face, fingerprint and iris.

Talk to an expert Start integrating

API contract sourceDigital Trusted Identity Service API And Kafka SpecificationsV1.2.260123

1:N BIOMETRIC IDENTIFICATION

Identification-group lifecycle

Keep 1:N identification distinct from 1:1 verification.

01InitializeFace · fingerprint · iris

02Appendadd identities

03Create Processx-group-id required

04PerformFACIAL / FINGERPRINT / IRIS

05Matchreturn subject

06Remove / Deletelifecycle control

FACE

FACIAL_IDENTIFICATION

1:N facial recognition.

FINGERPRINT

FINGERPRINT_IDENTIFICATION

1:N fingerprint recognition.

IRIS

IRIS_IDENTIFICATION

1:N iris recognition.

API REFERENCE

Source-backed contract: Initialize Identification Group

POST · /identification/v1/initialize/group

Endpoint & purpose

POST /identification/v1/initialize/group. Initialize subjects for 1:N face, fingerprint or iris identification.

Authentication

Bearer . Do not replace this mechanism with assumptions from legacy documentation.

Publication scope

PARTNER. Source: CheckID API contract V1.2.260123 §2.2.2.

Request shape

{
  "process_type": "FACIAL_IDENTIFICATION",
  "identity_documents": [
    {
      "type": "CITIZEN_CARD",
      "value": "<DOCUMENT_NUMBER>"
    }
  ]
}

Response shape

{
  "x-group-id": "FACIAL_IDENTIFICATION_<GROUP_ID>",
  "status": 201
}

Failure / recovery

Error semantics must use the raw contract/error catalogue; retry/idempotency/timeout behavior is applied only when a corresponding source defines it.