---
title: "List query results"
method: GET
path: "/query"
tags: ["Query"]
---

# List query results

`GET /query`

## Request

- Base URL: `https://api.cloudglue.dev/v1`
- URL: `https://api.cloudglue.dev/v1/query`
- Auth: HTTP bearer

List all query runs with pagination and filtering options. List items omit the columns and rows payloads — fetch an individual run via GET /query/{id} for the full result.

## Query parameters

- `limit` integer
- `offset` integer
- `status` 'completed' | 'failed' | 'in_progress' | 'cancelled'
- `created_before` string, date
- `created_after` string, date

## Response `200`

List of query results

- QueryListResponse
  - `object` 'list': Object type identifier
  - `data` QueryListItem[]: Array of query result items (without columns or rows)
    - `id` string, uuid: Query result ID
    - `object` 'query_result': Object type identifier
    - `status` 'completed' | 'failed' | 'in_progress' | 'cancelled': Current status
    - `created_at` number: Unix timestamp of creation
    - `collections` string[]: Collection IDs the query ran over
    - `sql` string, nullable: The effective SQL that was executed
    - `row_count` integer: Number of rows returned
    - `truncated` boolean: Whether the result was truncated
    - `usage` QueryUsage
      - `files_scanned` integer: Number of files loaded into the files virtual table
      - `entity_rows` integer: Number of rows loaded into the entities virtual table
      - `segment_entity_rows` integer: Number of rows loaded into the segment_entities virtual table
      - `engine_ms` number: SQL execution time in milliseconds
      - `total_ms` number: Total processing time in milliseconds, including dataset preparation
    - `error` object, nullable: Error details if the query failed
      - `code` string
      - `message` string
  - `total` integer: Total number of query results
  - `limit` integer: Maximum number of items returned
  - `offset` integer: Number of items skipped

## Other responses

- `500`: An unexpected error occurred on the server

## Changes

- **2026-10-30** `23d3f240819f`: 1 info
  - added the optional property `code` to the response with the `500` status
- **2026-08-02** `a7a390d80571`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cloudglue/apis/cloudglue-api/changes/query/get.md)

---

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