---
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

---

[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)