---
title: "List Queries"
method: GET
path: "/v2/queries"
tags: ["queries"]
---

# List Queries

`GET /v2/queries`

List your stored queries, newest first, scoped to the environment of the API key you call with (a production key lists production queries).

Page with `cursor` until `next_cursor` is null; there is no total count. A page can be shorter than `limit` while `next_cursor` is still set when a filter trimmed it. Your key's environment is part of the index, so pages come back full in either direction; `collection` and `status` are applied while reading, so a page can be shorter than `limit` while `next_cursor` is still set, and the API keeps reading to fill it. `from` and `to` bound the window on the index, so pair them with the other filters on large histories.

`include` inlines the same bodies `GET /v2/queries/{query_id}` returns, per row, so a feed and its previews can come from one request: `results` (retrieved chunks in one normalised shape), `request`, `response`. Each costs a stored-body read, so `limit` is capped at 25 when `include` is set. The four body fields are always present on every row and null unless requested.

History contains completed, non-streamed queries. Bodies are archived 90 days after the query (`body_status: archived`); the summary rows are kept.

## Query parameters

- `collection` string, nullable
- `status` string, nullable
- `from` string, nullable
- `to` string, nullable
- `sort` string, nullable
- `limit` integer
- `cursor` string, nullable
- `include` string, nullable

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- QueryListResponseV2
  - `queries` QuerySummaryV2[], required
    - `query_id` string, required
    - `query_text` string, nullable
    - `collection_name` string, nullable
    - `environment` string, nullable
    - `status` string, nullable
    - `api_version` string, nullable
    - `created_at` string, nullable
    - `latency_ms` integer, nullable
    - `result_count` integer, nullable
    - `request_id` string, nullable
    - `params` QueryParamsV2
      - `limit` integer, nullable
      - `semantic_ratio` number, double, nullable
      - `has_filter` boolean, nullable
      - `has_boost` boolean, nullable
      - `exclude_chunk_types` string[], nullable
      - `include` QueryParamsV2Include
    - `results` QueryResultV2[], nullable
      - `rank` integer, required
      - `chunk_id` string, nullable
      - `score` number, double, nullable
      - `rerank_score` number, double, nullable
      - `text` string
      - `filename` string, nullable
      - `document_id` string, nullable
      - `modality` string, nullable
      - `chunk_type` string, nullable
      - `location` QueryResultLocationV2
        - `page_start` integer, nullable
        - `page_end` integer, nullable
        - `start_seconds` number, double, nullable
        - `end_seconds` number, double, nullable
        - `sheet_name` string, nullable
        - `row_start` integer, nullable
    - `request` QuerySummaryV2Request
    - `response` QuerySummaryV2Response
    - `body_status` string, nullable
  - `count` integer, required
  - `next_cursor` string, nullable

## Other responses

- `400` — Invalid status, sort, include, time range, limit, or cursor
- `401` — Missing or invalid API key
- `403` — The API key does not have query permission

## Changes

- **2026-09-24** `61a9364ad042` — 1 breaking, 2 warning, 2 info
  - removed the required property `error` from the response with the `400` status
  - removed the optional property `details` from the response with the `400` status
  - removed the optional property `success` from the response with the `400` status
  - the response property `path` became required for the status `400`
  - …1 more
- **2026-09-12** `d07ce3783494` — 1 info
  - api operation id `list-queries-v-2` removed and replaced with `queries_list_queries_v2`
- **2026-09-08** `8a4e045bc3fa` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/runcaptain/apis/api-reference/changes/v2/queries/get.md)

---

[API](https://skmtc.dev/runcaptain/apis/api-reference.md) · [All operations](https://skmtc.dev/runcaptain/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/runcaptain/apis/api-reference/revisions/ac61e472bb7d?raw)