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

# List Sessions

`GET /sessions`

List sessions for the organization.

Returns paginated sessions with optional filtering by project, status, and date range.

## Query parameters

- `project_id` string, uuid, nullable — Filter by project ID
- `status` string, nullable — Filter by status
- `start_date` string, date-time, nullable — Filter sessions after this date
- `end_date` string, date-time, nullable — Filter sessions before this date
- `limit` integer — Number of sessions to return
- `offset` integer — Number of sessions to skip

## Headers

- `x-api-key` string, nullable

## Response `200`

Successful Response

- PaginatedSessions — Paginated response for session list.
  - `items` PublicSession[], required
    - `id` string, uuid, required
    - `project_id` string, uuid, nullable, required
    - `duration_seconds` integer, nullable, required
    - `status` string, required
    - `created_at` string, date-time, required
    - `email` string, nullable, required
    - `summary` string, nullable, required
    - `intent_rate` integer, nullable, required
    - `intent_name` string, nullable, required
    - `labels` object, nullable, required
    - `metadata` object, nullable, required
    - `tracked_journeys` object, nullable, required
    - `excluded_from_analytics_at` string, date-time, nullable — Set when an operator marked this session as not counting towards analytics (monitoring or test traffic). The session is still real and still listed here — this flag is what lets you leave it out of your own numbers. Null means it counts normally.
    - `goals` string[] — IDs of goal journeys completed in this session
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/karumi/apis/karumi-public-api.md) · [All operations](https://skmtc.dev/karumi/apis/karumi-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/karumi/karumi-public-api/revisions/8e5e6a464b81/schema)