---
title: "Parse and explain query without executing"
method: GET
path: "/query/explain"
tags: ["Query"]
---

# Parse and explain query without executing

`GET /query/explain`

Returns the parsed pipeline, estimated cost, fields involved, and MV acceleration availability.
Powers autocomplete, red-underline validation, and query planner UI.

## Query parameters

- `q` string, required

## Response `200`

Query explanation

- QueryExplainResponse
  - `data` object, required
    - `parsed` object
      - `pipeline` object[]
      - `result_type` 'events' | 'aggregate' | 'timechart'
      - `estimated_cost` 'low' | 'medium' | 'high'
      - `uses_full_scan` boolean
      - `fields_read` string[]
      - `fields_produced` string[]
    - `acceleration` object
      - `available` boolean
      - `view` string
      - `reason` string
      - `estimated_speedup` string
    - `is_valid` boolean
    - `errors` object[]
      - `position` integer
      - `length` integer
      - `message` string
      - `suggestion` string

---

[API](https://skmtc.net/lynxbase/apis/lynxdb-api.md) · [All operations](https://skmtc.net/lynxbase/apis/lynxdb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lynxbase/lynxdb-api/versions/4363a070c444/schema)