---
title: "Returns sessions history"
method: GET
path: "/sessions"
tags: ["Session"]
---

# Returns sessions history

`GET /sessions`

Returns list of sessions history filtered by given query

## Query parameters

- `page_size` integer
- `page` integer
- `date_from` string, date
- `date_to` string, date
- `direction` string
- `consumer_id` string
- `hermes_id` string
- `provider_id` string
- `service_type` string
- `status` string

## Response `200`

List of sessions

- SessionListResponse
  - `items` SessionDTO[]
    - `bytes_received` integer
    - `bytes_sent` integer
    - `consumer_country` string
    - `consumer_id` string
    - `created_at` string
    - `direction` string
    - `duration` integer — duration in seconds
    - `hermes_id` string
    - `id` string
    - `ip_type` string
    - `provider_country` string
    - `provider_id` string
    - `service_type` string
    - `status` string
    - `tokens` string
  - `page` integer — The current page of the items.
  - `page_size` integer — Number of items per page.
  - `total_items` integer — The total items.
  - `total_pages` integer — The last page of the items.

## Other responses

- `400` — Failed to parse or request validation failed
- `500` — Internal server error

---

[API](https://skmtc.net/mysteriumnetwork/apis/tequila-api.md) · [All operations](https://skmtc.net/mysteriumnetwork/apis/tequila-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mysteriumnetwork/tequila-api/revisions/cb1439736b63/schema)