---
title: "List or search stored sessions"
method: GET
path: "/sessions"
tags: ["sessions"]
---

# List or search stored sessions

`GET /sessions`

## Request

- Base URL: `https://api.aquavoice.com/v1`
- URL: `https://api.aquavoice.com/v1/sessions`
- Auth: HTTP bearer

Returns the user's visible stored dictations, newest first. Redacted
and deleted sessions and history cleared by the user are excluded.
Privacy mode stops future storage but does not hide earlier history.
Enterprise zero-data-retention policy blocks product history. Search
requires all meaningful query words to occur in one transcript. Results
identify the matching source and include a centered snippet. Reads
never start new AI work. One request reads a bounded part of the
history, so a page can have fewer results than `limit`, or none, while
`has_more` is true. Use `next_cursor` to read older sessions, or
`since` and `until` to narrow a search. With `expand=transcript`, each
session also has its complete transcript, so you can export the history
one page at a time.

## Query parameters

- `cursor` string
- `limit` integer
- `query` string
- `since` string, date-time
- `until` string, date-time
- `expand` string

## Response `200`

A keyset-paged session list.

- SessionPage
  - `object` 'list', required
  - `data` SessionSummary[], required
    - `object` 'session', required
    - `id` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `status` string, required
    - `title` string, required
    - `app` string, nullable, required
    - `duration_seconds` number, nullable, required
    - `word_count` integer, required
    - `preview` string, required
    - `match` SessionSearchMatch
      - `source` 'final_text' | 'raw_text', required
      - `snippet` string, required
    - `transcript` SessionTranscript
      - `object` 'transcript', required
      - `session_id` string, required
      - `final_text` string, required
      - `raw_text` string, nullable, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `default`: Product API error.

---

[API](https://skmtc.dev/aquavoice/apis/aqua-api.md) - [All operations](https://skmtc.dev/aquavoice/apis/aqua-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aquavoice/apis/aqua-api/revisions/f0139c07aded?raw)