---
title: "List sessions"
method: GET
path: "/api/sessions/"
tags: ["sessions"]
---

# List sessions

`GET /api/sessions/`

## Request

- Base URL: `https://api.overmindlab.ai`
- URL: `https://api.overmindlab.ai/api/sessions/`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - API key in cookie `sessionid`
  - API key in header `X-Api-Key`
  - HTTP bearer

One row per session — traces grouped by the ``conversation.id`` span attribute. Aggregates (trace/span counts, activity window, tokens, cost) are computed across every span of the session.

## Query parameters

- `capability` string, uuid
- `created_after` string, date-time
- `created_before` string, date-time
- `ordering` string
- `page` integer
- `page_size` integer
- `project` string, uuid
- `search` string

## Response `200`

- PaginatedSessionList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` Session[], required
    - `id` string, uuid, required
    - `external_id` string, required
    - `name` string, required
    - `project` string, uuid, required
    - `capability` string, uuid, nullable, required
    - `capability_name` string, nullable, required
    - `trace_count` integer, required
    - `span_count` integer, required
    - `first_span_ns` integer, nullable, required
    - `last_span_ns` integer, nullable, required
    - `session_score` number, double, nullable, required
    - `total_tokens` integer, nullable, required
    - `total_cost` number, double, nullable, required
    - `model` string, nullable, required
    - `created_at` string, date-time, required

---

[API](https://skmtc.dev/overmindlab/apis/overmind-api.md) - [All operations](https://skmtc.dev/overmindlab/apis/overmind-api/llms.txt) - [OpenAPI document](https://skmtc.dev/overmindlab/apis/overmind-api/revisions/0ecfd39e80c6?raw)