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

# List Queries

`GET /api/v1/queries`

## Query parameters

- `status` 'Queued' | 'Running' | 'Stopping' | 'Stopped' | 'Complete' | 'Error' — All possible query status values
- `dataset_id` string, uuid, nullable
- `exclude_no_code` boolean, nullable
- `exclude_code` boolean, nullable
- `query_types` 'NATURAL_LANGUAGE' | 'SQL' — All possible query types
- `offset` integer
- `limit` integer

## Headers

- `Authorization` string, required

## Request body

- QueriesBodyListQueriesApiV1QueriesGet
  - `query_ids` string[], nullable
  - `user_ids` string[], nullable
  - `exclude_user_ids` string[], nullable

## Response `200`

Successful Response

- QueriesAppApiV1SchemaListQueriesResponse
  - `meta` QueriesPagedMetaResponse, required — Metadata about the paginated response
    - `page` QueriesPagedPageDetailsResponse, required — Pagination metadata
      - `current_page` integer, required — Current page number
      - `limit` integer, required — Number of items returned in the list response
      - `offset` integer, required — Starting index returned for the list response
    - `links` QueriesPagedLinksDetailsResponse, required — Pagination metadata
      - `current` string, required — The current page link
      - `previous` string, nullable, required — The previous page, if applicable
      - `next` string, nullable, required — The next page link, if applicable
  - `data` QueriesAppApiV1SchemaGetQueryResponse[], required — The paginated data
    - `query_id` string, uuid, required
    - `query` string, required
    - `type` 'NATURAL_LANGUAGE' | 'SQL', required — All possible query types
    - `status` 'Queued' | 'Running' | 'Stopping' | 'Stopped' | 'Complete' | 'Error', required — All possible query status values
    - `results` string, nullable, required
    - `start_dt` string, date-time, nullable
    - `end_dt` string, date-time, nullable
    - `dataset_id` string, uuid, required
    - `total_row_count` integer, nullable
    - `parameters` object, nullable
    - `created_dt` string, date-time, required
    - `updated_dt` string, date-time, required
    - `created_user_id` string, required
    - `updated_user_id` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/coactive/apis/api-reference.md) · [All operations](https://skmtc.dev/coactive/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coactive/api-reference/revisions/1223758be9ba/schema)