# Sessions

After successful authorization, both company master user or company agent has access to the list of verification sessions (*Sessions* in Top Ribbon):

![Left sidebar / Sessions](https://724774130-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MVNVgV6Dh2kMg2n55Z5%2F-MWoxKNaZhohKQ1fIBdg%2F-MWoxaNyuoaEv-9KXi_W%2Fimage.png?alt=media\&token=ff1458d0-e6d2-4813-b87c-81b66ca62b52)

## Verification Sessions Page

![](https://724774130-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MVNVgV6Dh2kMg2n55Z5%2F-MWou8RwrardvrO_QLUs%2F-MWov_m1usn-SBc7pjck%2FAll%20Sessions%20-%20New.jpg?alt=media\&token=e01169c6-292c-4b2b-b148-1167f9df02c9)

The list shows all types of sessions, *successful* and *Failed*. There are several actions available on the page:

### Search

It is possible to search the verification sessions by: *first name, last name, person ID* or *document ID*. The list is automatically updated while typing, starting from the very first character.&#x20;

### Filters

The verification sessions can be filtered by several criteria:

#### Filter by Document type

User can be verified by two types of documents - passport or ID card. Accordingly, this filter enables the possibility to filter the sessions only by passport, ID card or both:

![Sessions filter by document type](https://724774130-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MVNVgV6Dh2kMg2n55Z5%2F-MWou8RwrardvrO_QLUs%2F-MWovpQnJMUVRPmd_6Cc%2Fimage.png?alt=media\&token=25591125-4b99-422d-ae54-2fa13d804d2e)

#### Filter by Final status

Final status of the user verification can be *Success* or *Failed*. Therefore, This filter filters the sessions with *Success*, *Failed* or both statuses:

![Sessions filter by final status](https://724774130-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MVNVgV6Dh2kMg2n55Z5%2F-MWou8RwrardvrO_QLUs%2F-MWovzKCWd9d0ErLWTBN%2Fimage.png?alt=media\&token=b33c4100-3dc1-4ddb-962b-15dca52ac6a6)

#### Filter by Possible spoof

Session verification might be failed due to various reasons. This filter gives the possibility to filter the sessions either according to the specific reason of fail or all together:

![Sessions filter by possible spoof](https://724774130-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MVNVgV6Dh2kMg2n55Z5%2F-MWou8RwrardvrO_QLUs%2F-MWowBKbk0K_gvWeCTj3%2Fimage.png?alt=media\&token=c77ed894-6d8f-488f-9a5f-2ff8bf8486d5)

1. **Digital Spoof Detected**: Cactusverify checks document validity. Therefore, if user presents the document via a screen (e.g.: mobile, PC, etc.), this session will fail.
2. **Is not Full ID**: the system verifies if the document was presented completely, i.e. if all the corners are completely visible and if an object is covering the document.
3. **Low FAR rate**: Here the system compares user's identified live face via camera, with the face on the presented document. After the comparison, compliance score is calculated, which is represented by FAR (False Acceptance Rate):
   1. Match Level 7 - 1/500,000 FAR
   2. Match Level 6 - 1/100,000 FAR
   3. Match Level 5 - 1/10,000 FAR
   4. Match Level 4 - 1/1,000 FAR
   5. Match Level 3 - 1/500 FAR
   6. Match Level 2 - 1/250 FAR
   7. Match Level 1 - 1/100 FAR

*FAR acceptance levels can be defined and modified by the **Master User** (for more details see* [*Settings*](https://kvalifika.gitbook.io/kvalifika/initial-setup/settings#awaiting-action)*).*

#### Filter by Date range

An Administrator can filter the session by the date range:

![Sessions filter by date range](https://724774130-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MVNVgV6Dh2kMg2n55Z5%2F-MWou8RwrardvrO_QLUs%2F-MWowSUwmNB5xzO54OBm%2Fimage.png?alt=media\&token=70d0a9e1-ab7d-4462-b137-5bdabc5a4bbf)

### Verifications List

The list of verification sessions has the following columns:

![](https://724774130-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MVNVgV6Dh2kMg2n55Z5%2F-MWou8RwrardvrO_QLUs%2F-MWowyfv03tsOmKw_uv-%2FAll%20Sessions%20-%20verification%20list.jpg?alt=media\&token=7c119590-e74c-40c7-aa84-984e38927f03)

* **Selfie**: photo taken by the user&#x20;
* **First Name**: first name of the user, taken from the presented document. If the name was not identified, asterisks are shown (\*\*\*\*\*\*).
* **Last Name**: last name of the user, taken from the presented document. If the name was not identified, asterisks are shown (\*\*\*\*\*\*).
* **Date**: date and time of the verification session.
* **Document**: whether the document is presented or not.
* **Liveness**: whether user liveness was successfully verified.&#x20;
* **Verified**: final status of the verification.
  * Yes
  * No
  * Pending
    * Pending indicates the state of the session when it is being processed which may take up to several minutes.
* **Extra**: if the company has defined any extra fields that should be filled, they are shown here (e.g. phone number, email, etc.). See [Settings](https://kvalifika.gitbook.io/kvalifika/initial-setup/settings#extra-fields) for more details.
* **More**: By clicking this icon (three dots) it is possible to navigate to and view specific verification session details (see [Session Details](https://kvalifika.gitbook.io/kvalifika/verification-session/sessions/all-session-details)).

The list can be refreshed by Refresh Button:

![Session list refresh](https://724774130-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MVNVgV6Dh2kMg2n55Z5%2F-MWou8RwrardvrO_QLUs%2F-MWox5YvPhdNmf_CqKQl%2Fimage.png?alt=media\&token=5e5965ad-d04d-47fe-b01e-249ae95fe76a)

The sessions list can be exported in excel (.csv) format:

![CSV export button](https://724774130-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MVNVgV6Dh2kMg2n55Z5%2F-MWou8RwrardvrO_QLUs%2F-MWoxEvzAIq6hSH4dIoa%2Fimage.png?alt=media\&token=348c00fd-d885-44c0-b79a-a301ac57006b)

The downloaded file will contain the following fields:

* Personal Number: *user personal number **(extracted from the document)***
* First Name: user's first name ***(extracted from the document)***
* Last Name: user's last name ***(extracted from the document)***
* Document Number: verification document ID ***(extracted from the document)***
* Birth Date: user birth date ***(extracted from the document)***
* Nationality: u*ser nationality **(extracted from the document)***
* Sex: u*ser gender: male/female **(extracted from the document)***
* Expiration Date: *Expiration date of the document in  the format: "mm-dd-yy" **(extracted from the document)***
* Verified: *TRUE/FALSE*
* Document Valid: *TRUE/FALSE*
* Liveness Status: *0 or 1*
* Match Level: *FAR level*
* Creation time: *verification session start date/time*&#x20;
* Completion time: *verification session end date/time*&#x20;
* Partner: *company name*
* Session ID: *a unique identifier, which is automatically assigned to every session*
* Extra: *Extra fields defined by the administrator*
* Document type: *passport or ID*
* Client IP: *IP of the verification session*
* Device: *Verification session device (PC or Mobile)*
* Browser: *Verification session device (e.g. Chrome, Edge, etc.)*
* OS: *OS of the verification (e.g. Android, Windows, etc.)*
* Model: *Model of the verification session device*
* Attempts: *sequence number of the verification attempt*

{% file src="<https://724774130-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MVNVgV6Dh2kMg2n55Z5%2F-MVkCbY5LXdyz-pCwK8x%2F-MVkClft65YsR8w-HYDD%2Fverifications.csv?alt=media&token=bc3461cd-ea88-4d3a-ada1-7ead2d1ee7d6>" %}
Sample downloaded file (.csv)
{% endfile %}


---

# Agent Instructions: 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:

```
GET https://kvalifika.gitbook.io/kvalifika/verification-session/sessions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
