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

# list sessions

`GET /v1/sessions`

Returns a list of all sessions for the organization

## Query parameters

- `page` integer
- `perPage` integer
- `search` string
- `apiKeyId` string, uuid
- `personaId` string, uuid
- `organizationId` string

## Response `200`

Successfully retrieved sessions

- object
  - `data` Session[]
    - `id` string, uuid — Unique identifier for the session.
    - `personaId` string, uuid, nullable — ID of the persona the client connected to, or `null` if the session was issued with an ephemeral persona config.
    - `clientLabel` string, nullable — Label supplied by the caller when minting the session token.
    - `startTime` string, date-time — Timestamp when the session started.
    - `endTime` string, date-time, nullable — Timestamp when the session ended, or `null` if still active.
    - `sessionLengthMs` integer, nullable — Duration of the session in milliseconds, or `null` if still active.
    - `exitStatus` string, nullable — How the session ended, or `null` if still active. Treat this as an open string set — new values may be added over time, so clients should handle unrecognised values gracefully rather than exhaustively matching. Known values: `CLOSED_BY_ENGINE`, `CLOSED_DANGLING_SESSION`, `HOST_FAILED_HEALTH_CHECK`, `HOST_UNREGISTERED`, `FAILED_TO_START`, `FAILED_PENDING_TIMEOUT`, `ORPHANED_NO_END_SIGNAL`.
    - `engineHost` string, nullable — Hostname of the engine pod that served the session.
    - `engineProtocol` string, nullable — Protocol used to stream the session (e.g. `https`).
    - `engineVersion` string, nullable — Version of the engine pod that served the session.
    - `clientMetadata` object — Arbitrary metadata collected from the client during the session.
    - `personaConfig` object — Snapshot of the persona configuration taken at the moment the session started.
    - `apiKeyId` string, uuid, nullable — ID of the API key that minted the session token.
    - `organizationId` string — ID of the organization that owns the session. IDs may be either UUIDs or nanoid-style strings depending on when the organization was created.
    - `createdAt` string, date-time — Timestamp when the session record was created.
    - `updatedAt` string, date-time, nullable — Timestamp when the session record was last updated.
  - `meta` Pagination — Pagination metadata returned alongside the `data` array of every list endpoint.
    - `total` integer — Total number of items across all pages.
    - `lastPage` integer — Number of the last page.
    - `currentPage` integer — Number of the current page.
    - `perPage` integer — Number of items per page.
    - `prev` integer, nullable — Number of the previous page, or null if on the first page.
    - `next` integer, nullable — Number of the next page, or null if on the last page.

## Other responses

- `400` — Bad request - Invalid query parameters
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - API key lacks the required permission
- `500` — Server error

---

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