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

# List Sessions

> Retrieve a paginated list of all verification sessions for your account.

## Query Parameters

<ParamField query="page" type="integer">
  Page number (default: `1`)
</ParamField>

<ParamField query="per_page" type="integer">
  Results per page, max 100 (default: `15`)
</ParamField>

<ParamField query="status" type="string">
  Filter by status: `created`, `processing`, `approved`, `declined`, `expired`
</ParamField>

<ParamField query="from" type="string">
  Filter sessions created after this date (`YYYY-MM-DD`)
</ParamField>

<ParamField query="to" type="string">
  Filter sessions created before this date (`YYYY-MM-DD`)
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET \
    "https://verilock.io/api/v1/sessions?status=approved&per_page=10" \
    -H "Authorization: Bearer qi_live_your_api_key_here" \
    -H "Accept: application/json"
  ```

  ```php PHP (Guzzle) theme={null}
  $client = new \GuzzleHttp\Client();
  $response = $client->get(
    'https://verilock.io/api/v1/sessions',
    [
      'headers' => [
        'Authorization' => 'Bearer qi_live_your_api_key_here',
        'Accept' => 'application/json',
      ],
      'query' => [
        'status' => 'approved',
        'per_page' => 10,
      ],
    ]
  );
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": [
      {
        "id": "ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "type": "kyc",
        "status": "approved",
        "reference_id": "usr_12345",
        "steps": ["document", "selfie", "face_match"],
        "applicant": {
          "first_name": "Jean",
          "last_name": "Dupont",
          "email": "jean.dupont@example.com"
        },
        "created_at": "2026-03-15T10:30:00Z",
        "completed_at": "2026-03-15T10:45:22Z"
      },
      {
        "id": "ses_f7e8d9c0-b1a2-3456-7890-abcdef123456",
        "type": "kyc",
        "status": "approved",
        "reference_id": "usr_67890",
        "steps": ["document", "selfie", "liveness", "aml"],
        "applicant": {
          "first_name": "Marie",
          "last_name": "Laurent",
          "email": "marie.laurent@example.com"
        },
        "created_at": "2026-03-14T08:15:00Z",
        "completed_at": "2026-03-14T08:32:10Z"
      }
    ],
    "meta": {
      "current_page": 1,
      "last_page": 4,
      "per_page": 10,
      "total": 38
    }
  }
  ```
</ResponseExample>