# Get sessions

Retrieves a list of Identity Verification sessions performed in a tenant, along with their results and metadata.

## Operation parameters

- **Return all**: Retrieves all Identity Verification sessions performed in the tenant in the last 24 hours. The response always includes the following default metadata:
  - `Time`
  - `Session Id`
  - `Status`
  - `Recommendations`
  - `Rejection Description`
- **Limit**: Defines the maximum number of sessions to return. If not specified, the default is 1000.
- **Add filter**: Narrows down the query results by excluding entries that do not meet the selected criteria. Filters control which results are returned, while the default output format — which includes only `Time`, `Session Id`, `Status`, `Recommendations`, and `Rejection Description` — remains unchanged. To extend the output with personally identifiable information, the **"Include PII"** filter must be explicitly set to `TRUE`.
  - **Application ID Names or IDs**: Includes sessions related to specific applications. Choose from the list or specify IDs using an expression.
  - **End Date**: Sets the latest date in the custom time range.
  - **Start Date**: Sets the earliest date in the custom time range.
  - **Verification Status**: Filters by one or more document verification outcomes:
    - `Error`
    - `Pending`
    - `Rejected`
    - `Resubmit`
    - `Success`
    - `Uncertain`
  - **Session Status**: Filters by one or more session lifecycle states:
    - `Capturing`
    - `Complete`
    - `Error`
    - `Expired`
    - `Pending`
    - `Processing`
    - `Recapture`
  - **Rejection Reason Names or IDs**: Includes sessions with selected rejection reasons. Choose from the list or specify their IDs using an expression.
    - `Data Extraction Failed`
    - `Data Validation Failed`
    - `Data Comparison Failed`
    - `Mrz Check Digits Invalid`
    - `Face Tampering`
    - `Face Not Found`
    - `Missing Security Features`
    - `Document Tampering`
    - `Wrong Font`
    - `Document Damaged`
    - `Document Template Mismatch`
    - `Presentation Attack`
    - `Biometric Mismatch`
    - `Age Mismatch`
    - `Gender Mismatch`
    - `Screen Capture`
    - `Printed Copy Capture`
    - `Printed Cutout`
    - `Mask Detected`
    - `Injection Attack Detected`
    - `Selfie Liveness Attack`
    - `Multiple Faces Detected`
    - `Multiple Same Identity Attempts`
    - `Previous Document Fraud`
    - `Previous Face Fraud`
    - `Repeated Face Fraud`
  - **Include PII**: If enabled, includes personally identifiable information (PII) in the response. When this is selected, the default session metadata is omitted from the results. Data includes:
    - `Full Name`
    - `Date Of Birth`
    - `Give Name`
    - `Surname`
    - `National Id`
    - `Gender`
    - `Address`
    - `Country`
    - `Region`
    - `Document Id`
    - `Type`
    - `Valid From`
    - `Valid Until`
    - `Document Name`


## Result

When the node is executed, it retrieves a list of Identity Verification sessions that match the selected filters. Each session is returned as a table row, a JSON object within an array, or a schema item—depending on how the data is used downstream. The output includes the default metadata (if **Include PII** is not selected) and any additional metadata specified through filters.

style
section article ul li {
        margin-top: 3px !important;
    }