IDCheck Headless
DOC_ID_HEADLESS:v2 introduces a unified Verification datablock but its implementation is not yet finalized. Use DOC_ID_HEADLESS:v1 for all production flows.
Automated verification using pre‑captured document and face images
Verifies identity using static evidence collected by the your own front end and submitted to IDnow via API.
In Headless mode, your application is responsible for collecting and providing identity evidence, such as images of the ID document and a selfie image of the user. IDnow then performs verification on these static inputs using AI-based analysis and data extraction modules. Unlike Capture mode, the Headless flow does not involve any user interaction within the IDnow front end; all evidence is provided directly by the customer’s system.
Because verification relies solely on static images, certain checks that require dynamic interaction or live capture cannot be performed. These include NFC chip reading and dynamic document validation (for example, visual inspection of holograms under movement or live liveness actions). As a result, Headless verification provides a more limited level of accuracy compared to Capture mode and is not suitable for regulated use cases such as KYC or AML processes.
Instead, Headless mode is best suited for unregulated scenarios, such as document data extraction, image quality assessment, or pre-validation steps where full dynamic verification is not required.
Key features
- Customer-managed evidence collection – The customer application captures and submits document and selfie images via API.
- Static evidence processing – Verification is performed using only static images, without live interaction or dynamic capture.
- AI-based analysis – Automated checks assess document authenticity, extract data, and compare facial features between the document and the selfie.
- Lightweight integration – Ideal for API-based use cases that require automated data extraction or streamlined verification flows.
Configuration
| Parameter | Type | Description |
|---|---|---|
| realm | string | The IDCheck.io realm used for document processing. |
Input data blocks
Input requirements for this step.
| Data block type | Required | Description |
|---|---|---|
DocumentImages | Yes | Contains vault references ({ "$ref": "vault", "$id": "<uuid>" }) to the identity document images. This data block is always required. |
Routes
| Route | Description |
|---|---|
verified | Document was successfully processed and identity data was extracted. |
not_verified | Document verification failed; no identity data could be extracted. |
fraud_detected | Document was identified as fraudulent; no identity data was extracted. |
Output data blocks
Data blocks produced per route.
| Route | Data blocks produced | Description |
|---|---|---|
| verified | BasicIdentity, ExtendedIdentity, DocumentData, DocumentImages, DocumentVerification | Successful document processing with identity extraction |
| not_verified | DocumentVerification | Document verification failed, no processing possible |
| fraud_detected | DocumentVerification | Document identified as fraudulent, no identity data extracted |