---
title: "Get Sessions"
method: GET
path: "/projects/{project_id}/sessions"
---

# Get Sessions

`GET /projects/{project_id}/sessions`

## Request

- Base URL: `https://usemeridian.us` (the document declares no server; this is the origin it was published from)
- URL: `https://usemeridian.us/projects/{project_id}/sessions`
- Auth: none declared

List sessions attached to the project.

Pass ``?active_only=false`` to include closed and archived sessions
(useful for the LIVE tab showing recent session outcomes).
Expires stale sessions (last_seen > 30 min ago) before returning so
the dashboard doesn't accumulate ghost entries indefinitely.

## Path parameters

- `project_id` string, required

## Query parameters

- `active_only` boolean

## Response `200`

Successful Response

- Session[]
  - `id` string, required
  - `project_id` string, required
  - `name` string, required
  - `human_id` string, nullable
  - `status` 'active' | 'idle' | 'closed' | 'archived', required
  - `last_seen` string, required
  - `created_at` string, required
  - `session_summary` unknown
  - `agent_framework` string, nullable
  - `client_type` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/usemeridian/apis/meridian.md) · [All operations](https://skmtc.dev/usemeridian/apis/meridian/llms.txt) · [OpenAPI document](https://skmtc.dev/usemeridian/apis/meridian/revisions/f37a894bd374?raw)
