> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firstwork.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Veriff

> Verify candidate identity with Veriff's AI-powered document and biometric verification

## Overview

Firstwork integrates with **Veriff** for identity verification. Candidates complete verification sessions where they present identification documents and a selfie, and Veriff uses AI to verify their identity in real-time.

## How It Works

```mermaid theme={null}
graph LR
    A[Candidate Reaches Verification Stage] --> B[Veriff Session Created]
    B --> C[Candidate Completes Verification]
    C --> D[Veriff Processes & Returns Result]
    D --> E{Verified?}
    E -->|Yes| F[Advance to Next Stage]
    E -->|No| G[Flag for Manual Review]
```

## Setup

### Get Veriff API credentials

1. Sign up at [Veriff](https://www.veriff.com)
2. Obtain your API key and secret

### Configure in Firstwork

Add Veriff integration in **Settings > Integrations > Veriff**.

### Configure verification flow

Set up which hiring flow stages require identity verification.

## Veriff Sessions

When a candidate needs to verify their identity:

1. A **Veriff session** is created with candidate data
2. The candidate receives a verification link
3. They upload their ID and take a selfie
4. Veriff processes the verification
5. Results are returned to Firstwork

### Session Status

| Status                 | Description                               |
| ---------------------- | ----------------------------------------- |
| Created                | Session initialized                       |
| Started                | Candidate opened verification link        |
| Submitted              | Candidate completed the verification flow |
| Approved               | Identity verified successfully            |
| Declined               | Verification failed                       |
| Expired                | Session timed out                         |
| Resubmission Requested | Additional documents needed               |

## Automation Integration

### Veriff Action

The **Veriff Action** in automations:

* Creates a verification session for the candidate
* Sends the verification link via email or SMS
* Monitors the session status
* Processes results and updates application data

### Processing Results

When Veriff returns results:

1. Session status is updated
2. Compliance rules evaluate the verification outcome
3. Extracted data (name, DOB, document number) is stored
4. Automations trigger based on the result

## Verified Data

Veriff can extract and verify:

* Full name
* Date of birth
* Document number
* Document expiry date
* Nationality
* Document type
* Face match confidence

This data can be mapped to form fields and used in compliance rules.