---
title: "Execute SPL2 query (GET convenience)"
method: GET
path: "/query"
tags: ["Query"]
---

# Execute SPL2 query (GET convenience)

`GET /query`

GET variant for simple queries. Use POST for complex or long queries.

## Query parameters

- `q` string, required
- `from` string
- `to` string
- `limit` integer
- `format` 'json'

## Response `200`

Query result

- union
  - QueryEventsResponse
    - `data` object, required
      - `type` 'events', required
      - `events` LogEvent[], required
      - `total` integer, required
      - `has_more` boolean
      - `partial` boolean — Present and `true` when served from a backfilling MV
    - `meta` object
      - `took_ms` number
      - `scanned` integer
      - `query_id` string
      - `accelerated_by` AcceleratedBy
        - `view` string — Name of the MV used
        - `original_scan` integer — Events that would have been scanned without MV
        - `speedup` string
        - `status` 'active' | 'backfilling'
        - `coverage_percent` number — Only present when MV is backfilling
  - QueryAggregateResponse
    - `data` object, required
      - `type` 'aggregate', required
      - `columns` string[], required
      - `rows` array[], required
        - unknown[]
          - unknown
      - `total_rows` integer
      - `partial` boolean
    - `meta` object
      - `took_ms` number
      - `scanned` integer
      - `query_id` string
      - `accelerated_by` AcceleratedBy
        - `view` string — Name of the MV used
        - `original_scan` integer — Events that would have been scanned without MV
        - `speedup` string
        - `status` 'active' | 'backfilling'
        - `coverage_percent` number — Only present when MV is backfilling
  - QueryTimechartResponse
    - `data` object, required
      - `type` 'timechart', required
      - `interval` string, required
      - `columns` string[], required
      - `rows` array[], required
        - unknown[]
          - unknown
    - `meta` Meta
      - `took_ms` number
      - `scanned` integer
      - `query_id` string

## Other responses

- `400` — Invalid SPL2 query

## Changes

- **2026-04-19** `495c1db0a075` — 2 breaking
  - removed the enum value `csv` from the `query` request parameter `format`
  - removed the enum value `raw` from the `query` request parameter `format`
- **2026-03-03** `7141381739ac` — 2 info
  - added the new enum value `csv` to the `query` request parameter `format`
  - added the new enum value `raw` to the `query` request parameter `format`

[Change history](https://skmtc.dev/lynxbase/apis/lynxdb-api/changes/query/get.md)

---

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