AQaquavoice
sessions

List or search stored sessions

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.

get/sessions

Request

  • Base URL
    https://api.aquavoice.com/v1
  • Auth
    HTTP bearer

Query parameters

cursorstring

Opaque next_cursor from the previous page. Cursors expire after 30 days and are bound to the original filters. A changed or expired cursor returns invalid_cursor.

limitinteger
querystring
sincestring date-time
untilstring date-time
expandstring
Example:transcript

A comma-separated list of the parts to add to each session: transcript. Another value returns 400 invalid_expand.

Response

A keyset-paged session list.

object'list' required
has_moreboolean required
next_cursorstring nullable required

Example response

{
  "data": [
    {
      "id": "ses_a1e2c85b1cbf43af9dc678a1a7423dcc",
      "status": "stopped",
      "title": "The beta is stable enough to expand next week.",
      "app": "Zoom",
      "duration_seconds": 1842.7,
      "word_count": 4218,
      "preview": "The beta is stable enough to expand next week.",
      "match": {
        "source": "final_text",
        "snippet": "The team approved a wider beta for Tuesday."
      },
      "transcript": {
        "session_id": "ses_a1e2c85b1cbf43af9dc678a1a7423dcc",
        "final_text": "The beta is stable enough to expand next week.",
        "raw_text": "the beta is stable enough to expand next week"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.