---
title: "Get Sessions"
method: GET
path: "/sessions"
tags: ["Sessions"]
---

# Get Sessions

`GET /sessions`

---
title: List sessions
group: [ENDPOINTS]
---

List of all sessions

## Query parameters

- `page` integer
- `size` integer
- `email` string
- `visitor_id` string
- `tz` string
- `date_from` union
  - string
  - 'TODAY' | 'YESTERDAY' | 'BEGINNING_OF_WEEK' | 'BEGINNING_OF_MONTH' | 'BEGINNING_OF_PREV_MONTH' | 'TODAY-7DAYS' | 'TODAY-30DAYS' — * `TODAY` - Today since midnight * `YESTERDAY` - Yesterday since midnight * `BEGINNING_OF_WEEK` - Nearest monday since midnight * `BEGINNING_OF_MONTH` - 1st of the month since midnight * `BEGINNING_OF_PREV_MONTH` - Previous 1st of the month since midnight * `TODAY-7DAYS` - Exact 7 days ago since midnight * `TODAY-30DAYS` - Exact 30 days ago since midnight
- `date_to` union
  - string
  - 'TODAY' | 'YESTERDAY' | 'BEGINNING_OF_WEEK' | 'BEGINNING_OF_MONTH' | 'BEGINNING_OF_PREV_MONTH' | 'TODAY-7DAYS' | 'TODAY-30DAYS' — * `TODAY` - Today since midnight * `YESTERDAY` - Yesterday since midnight * `BEGINNING_OF_WEEK` - Nearest monday since midnight * `BEGINNING_OF_MONTH` - 1st of the month since midnight * `BEGINNING_OF_PREV_MONTH` - Previous 1st of the month since midnight * `TODAY-7DAYS` - Exact 7 days ago since midnight * `TODAY-30DAYS` - Exact 30 days ago since midnight

## Response `200`

Successful response

- GetListSessionsResponse
  - `total` integer
  - `page` Pagination
    - `num` integer
    - `size` integer
  - `sessions` Session[]
    - `id` string
    - `website_id` string
    - `session_url` string
    - `creation_timestamp` integer
    - `duration` integer
    - `end_timestamp` integer
    - `active_time` integer
    - `end_url` string
    - `expiration_timestamp` integer
    - `last_event_timestamp` integer
    - `product` string
    - `device` string
    - `tags` string[]
    - `last_seen_page_view_id` string
    - `seen` boolean
    - `referrer` string
    - `start_url` string
    - `visitor_first_session` boolean
    - `engagment_score` number
    - `visitor` SessionVisitorData
      - `id` string
      - `ip` string
      - `geolocation` SessionVisitorDataGeolocation
        - `country_code` string
        - `city` string
        - `region` string
      - `name` string
      - `email` string
      - `email_hash` string
      - `params` SessionVisitorDataParams[]
        - `name` string
        - `value` string
      - `last_session_timestamp` integer
      - `first_session_timestamp` integer
    - `resolution` SessionResolutionData
      - `height` integer
      - `width` integer
      - `resolution` string
    - `os` SessionOsData
      - `name` string
      - `version` string
    - `browser` SessionBrowserData
      - `description` string
      - `name` string
      - `version` string
    - `utm` SessionUTMData
      - `source` string
      - `medium` string
      - `campaign` string
      - `term` string
      - `content` string
    - `page_views_statistics` SessionPageViewsStatisticsData
      - `count` integer
    - `events_statistics` SessionEventsStatisticsData
      - `clicks` integer
      - `error_clicks` integer
      - `rage_clicks` integer
      - `error_logs` integer
      - `net_errors` integer

## Other responses

- `400` — 400 response
- `500` — 500 response

---

[API](https://skmtc.dev/livesession/apis/livesession-api.md) · [All operations](https://skmtc.dev/livesession/apis/livesession-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/livesession/livesession-api/revisions/68a9c0d325b4/schema)