> For the complete documentation index, see [llms.txt](https://docs.1kosmos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.1kosmos.com/identity-verification/configurations.md).

# Configurations

***

### Configuring Verification Flows

| Journey Type                   | Description                                                                                                                                                      |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **KYC with Selfie**            | Combines document verification with face liveness and selfie matching. Users are prompted to scan an identity document and then capture a selfie for comparison. |
| **Document Verification Only** | Enables standalone document verification without any selfie or liveness check.                                                                                   |

Each journey is created in three steps:

1. **Select workflow type** — Choose between **KYC with Selfie** or **Document Verification Only**, and provide details such as the workflow name, type, last modified date, and creator.
2. **Select verification configuration** — Restrict allowed documents by country, region, and type; configure PII data retention policies; and enable first and last name matching for identity comparison.
3. **Manage face liveness and face matching threshold** — Configure Face Liveness (**Soft**, **Regular**, or **Hardened**) and set the Face Comparison Threshold (default: **50%**) to control the sensitivity of biometric matching.

***

### Configuring KYC with Face Comparison

The KYC with Face Comparison journey consists of two main steps:

1. **Defining documents for verification** — Specify the list of documents accepted for verification.
2. **Configuring face liveness settings** — Set the liveness calibration and face matching threshold.

**Step 1: Defining Documents for Verification**

| Field                                                                                          | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Journey Name**                                                                               | Specify a name for the verification journey.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **Unique Tag**                                                                                 | <p>Specify a unique tag used by API callers to create sessions. The tag must be unique and <strong>cannot be changed once set</strong>. </p><p></p><p><em>Allowed characters:</em> <code>/^\[a-zA-Z0-9\_-]\*$/i</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Allowed Document Types**                                                                     | <p>Select which document types are permitted for verification based on country and region. Only the selected types are accepted. </p><p>By default, the <strong>Allow</strong> toggle is selected and the <strong>Allowed Document Types</strong> dropdown is displayed. Switching the toggle to <strong>Block</strong> displays the <strong>Blocked Document Types</strong> dropdown instead, where you select the documents to restrict. </p><p>• In the <strong>Allowed Document Types</strong> window, click <strong>Allow all documents</strong> to permit all supported documents.</p><p>• Specify the country and region to narrow down which documents are available for selection. </p><p>The <strong>region</strong> determines whether the document format is national (used across the country) or regional (specific to a state or locality): </p><p>• <strong>Region: National</strong> — the document follows a country-wide format. </p><p> <em>Example:</em> Country: India, Region: National, Document Type: Driver License → Displayed as <strong>INDIA, DRIVER LICENSE</strong>. Although <strong>NATIONAL</strong> is not shown in the label, this refers to a standardized national document format. </p><p>• <strong>Specific region (e.g., state)</strong> </p><p><em>Example:</em> Country: India, Region: Andhra Pradesh, Document Type: Driver License → Displayed as <strong>INDIA, ANDHRA PRADESH, DRIVER LICENSE</strong>. </p><p>National and regional formats must be selected individually — choosing one does not automatically include the other.</p> |
| **Allow/Block Toggle**                                                                         | Choose whether the selected documents are explicitly allowed or blocked.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Data Configuration**                                                                         | <p>Specifies how long verification data is retained for each session outcome (<strong>Success</strong>, <strong>Failed</strong>, <strong>Not Performed</strong>, <strong>Review</strong>, and <strong>Abandoned</strong>). Options:</p><p>• Discard data immediately </p><p>• Discard data after caller retrieves result </p><p>• Discard data after specified time</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Discard Data After** *(appears only when **Discard data after specified time** is selected)* | Specify the number of days or minutes after which the verification data is discarded.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

**Use Case**

| Field                            | Description                                                                                                                                              |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Context**                      | Defines the verification use case, such as remote or in-person verification.                                                                             |
| **Document Verification Policy** | Sets the policy for document analysis. **Standard** is recommended for most use cases. Options: Permissive, Standard (recommended), Strict, Very Strict. |
| **Retry Count**                  | Maximum number of retry attempts allowed during the verification process.                                                                                |

**Expiration Intervals**

| Field                     | Description                                                                  |
| ------------------------- | ---------------------------------------------------------------------------- |
| **From Session Creation** | Sets how long a session remains valid if it has not been accessed.           |
| **From Session Start**    | Sets how long a session remains valid after it has been started by the user. |

**Data Comparison**

| Field                        | Description                                                                                                                                                                                                                                                                                                                                                                         |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Select from the list**     | Choose which user data (e.g., First name, DOB) is compared against document data.                                                                                                                                                                                                                                                                                                   |
| **Ignore middle names**      | When enabled, middle names are excluded from name comparison during ID proofing to improve match accuracy between directory data and identity documents. Only the first word of the first name is evaluated from both the user metadata and the identity document; any additional names in the document's first name field are ignored. Last name comparison behavior is unchanged. |
| **Fuzzy Match (First Name)** | Enables approximate matching for the first name. Useful for handling spelling variations.                                                                                                                                                                                                                                                                                           |
| **Fuzzy Match (Last Name)**  | Enables approximate matching for the last name.                                                                                                                                                                                                                                                                                                                                     |
| **Fuzzy Match Slider**       | Adjusts the threshold for fuzzy matching (recommended range: **70–80%**).                                                                                                                                                                                                                                                                                                           |
| **Date of Birth Comparison** | Compares the entered date of birth with the extracted document data. Exact match only.                                                                                                                                                                                                                                                                                              |
| **Continue**                 | Proceeds to the next step in setting up the verification journey.                                                                                                                                                                                                                                                                                                                   |

**Behavior of Fuzzy Match and Ignore Middle Names**

The **Ignore Middle Names** option can be used on its own or together with **Fuzzy Match**.

* When both options are enabled, fuzzy matching is applied to the first word of the first name.
* Fuzzy matching continues to apply to the full last name value.

**Example Scenarios**

| First Name (User)      | First Name (Document)   | Ignore Middle Names | Fuzzy Match | Result |
| ---------------------- | ----------------------- | ------------------- | ----------- | ------ |
| Mike                   | Mike Johnson            | Enabled             | —           | Pass   |
| Mike Alexander Johnson | Mikee Alexander Johnson | Enabled             | Enabled     | Pass   |
| Mike Alexander Johnson | Mikee Alexander Johnson | Enabled             | Disabled    | Fail   |

**Step 2: Configuring Face Liveness Settings**

| Field                                 | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Liveness Levels**                   | <p>Determines the calibration level for liveness detection to balance convenience and security:</p><p>• <strong>Regular</strong> — Default setting. Provides acceptable security with higher user convenience. </p><p>• <strong>Soft</strong> — Reduces false rejections of genuine users while maintaining some error tolerance in detecting spoofing or presentation attacks. </p><p>• <strong>Hardened</strong> — Highest security setting. Strongly reduces spoofing risks but increases the chance of mistakenly rejecting legitimate users.</p> |
| **Face Matching Score**               | Defines the threshold for similarity between a live face and the reference image. Recommended range: **50–80%**. Adjustable using the slider.                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Back** (button)                     | Navigates back to the previous step in the verification flow setup.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Create Verification Flow** (button) | Saves the configuration and creates the verification flow.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.1kosmos.com/identity-verification/configurations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.