> 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/monitoring-and-analytics/verification-sessions.md).

# Verification Sessions

Continuously monitor every identity verification session — spot risky attempts instantly, filter by outcome and signals, and trace a person's full verification history at a glance.

### Overview

Previously, identity verification activity review meant working with a fixed set of columns and only session-level results, with no way to filter by risk-oriented criteria or see a single person's history across multiple attempts.

A new **Sessions (BETA)** page has been added under Verification in the AdminX interface, with a customizable table, richer filtering and search, and a new way to view activity grouped by user rather than by individual session.&#x20;

{% hint style="info" %}
The Sessions page includes nine optional filters and 14 customizable columns to display in the results table.
{% endhint %}

<figure><img src="https://691395313-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjgyVKgYJP0xNjsiKAcPm%2Fuploads%2FtaSFK9LDHSP3CWqLSdfJ%2Fsessionspage.png?alt=media&amp;token=fc841f76-0279-43cb-9653-b40670e85309" alt=""><figcaption></figcaption></figure>

The **Sessions** page lets you:

* Analyze verification activity across sessions — outcomes, risk levels, detected signals, and locations.
* Investigate a single person's history across multiple attempts.&#x20;
* Customize which columns appear, filter, and search to focus on the sessions that matter.
* Switch between viewing every session and viewing activity grouped by user.

#### Navigation

In AdminX, go to **Verification → Sessions**.

By default, the page shows the **All Sessions** view for **Today**, with 25 sessions per page.

### What actions community administrators can perform

* [#switch-between-all-sessions-and-unique-users](#switch-between-all-sessions-and-unique-users "mention")
* [#customize-the-table-columns](#customize-the-table-columns "mention")
* [#filter-sessions](#filter-sessions "mention")
* [#search](#search "mention")
* [#sort-and-view-time-period](#sort-and-view-time-period "mention")
* [#view-session-details](#view-session-details "mention")

#### Switch between All Sessions and Unique Users

Use the **All Sessions / Unique Users** toggle above the table:

* **All Sessions** (default) shows every individual verification session as its own row. If a person completes five sessions, it appears as five rows.
* **Unique Users** groups all of a person's sessions into a single row. A unique user is identified by First Name + Last Name + Date of Birth, so sessions from the same person are combined.

<figure><img src="https://691395313-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjgyVKgYJP0xNjsiKAcPm%2Fuploads%2FS4jcVVZd1fpz8wfiHOHW%2Fuserview.png?alt=media&amp;token=2da97e20-f7a3-47c0-8b81-2823a183a4d5" alt=""><figcaption></figcaption></figure>

In the Unique Users view, each row summarizes the user's attempts — for example, "8 Attempts, 1 failed · 7 passed" — along with their risk level and signals detected. Expanding a row shows the user's sessions, 5 per page, up to the 10 most recent, sorted latest first.

#### Customize the table columns

Click **Edit Table View** to choose which columns appear.

* Checked columns are shown; unchecked columns are hidden.
* Some core columns (such as Identity) are always present and cannot be removed.
* Some columns are available only for specific view types.
* Click **Apply** to update the table, or **Cancel** to close without changes.
* **Reset to Default** restores the default columns; it is available only after you have changed the layout.

When you show many columns, the table scrolls horizontally while the Identity and Actions columns stay in place. Columns always appear in their defined order regardless of the order you select them.

#### Filter sessions

Use the filters to narrow the sessions shown. Only filters for columns that are currently visible are offered, and filters apply as soon as they are selected.

* **Journey** — multi-select and searchable; filter across one or more verification journeys.
* **Failure reasons** — IDV failure codes shown as readable reasons, grouped into categories (for example, Document Authenticity & Liveness, Biometric / Selfie Verification). Selecting multiple reasons returns sessions containing any of them.
* **Document Type** — Searchable, multi-select, grouped into Physical Documents and Electronic IDs; only document types enabled for your tenant are shown.
* **Outcome** — All, Passed, Failed, Not Performed, or Review.
* **Status** — All, In Progress, Pending, Abandoned, Expired, Declined, or Completed (shown when the Status column is visible).
* **Risk** — All, Low, Medium, or High.
* **Signals** — The five supported risk signals in this phase; multi-select.

<figure><img src="https://691395313-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjgyVKgYJP0xNjsiKAcPm%2Fuploads%2FRQdnwfYAT7oq70slTc9H%2Ffilters.png?alt=media&amp;token=bc9adede-9525-4b51-86d6-37f4c40dda3b" alt=""><figcaption></figcaption></figure>

Active filters appear as chips. When there are many, the list scrolls and shows a "+N" indicator you can hover to see the full list. Filters apply consistently to both All Sessions and Unique Users — the page first finds the matching sessions, then groups them in the Unique Users view, so the aggregates reflect the current filters and time period.

#### Search

Use the search field to find sessions by Session ID or by a user's first and last name. Any filters you have applied stay active while you search.

#### Sort and view time period

* **Sort by** — Latest or Risk Level.
* **Time period** — Today, This Week, 1 Month, or Select dates for a custom range.

#### View session details

Select a session's **View Details** action to open its Session Detail view on a separate page.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.1kosmos.com/identity-verification/monitoring-and-analytics/verification-sessions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
