---
title: "Get a session"
method: GET
path: "/api/sessions/{id}/"
tags: ["sessions"]
---

# Get a session

`GET /api/sessions/{id}/`

## Request

- Base URL: `https://api.overmindlab.ai`
- URL: `https://api.overmindlab.ai/api/sessions/{id}/`
- 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

Read-only sessions API — list with aggregates + detail.

## Path parameters

- `id` string, uuid, required

## Response `200`

- Session: ``GET /api/sessions/`` row. Counts come from ``SessionViewSet`` annotations; token/cost totals from the per-page ``session_usage`` context map.
  - `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)