---
title: "Execute a batch query"
method: GET
path: "/query"
tags: ["odf-query"]
---

# Execute a batch query

`GET /query`

Functions exactly like the [POST version](#tag/odf-query/POST/query) of the
endpoint with all parameters passed in the query string instead of the body.

## Query parameters

- `query` string, required
- `queryDialect` string
- `skip` integer
- `limit` integer
- `dataFormat` 'JsonAoS' | 'JsonSoA' | 'JsonAoA'
- `schemaFormat` 'ArrowJson' | 'OdfJson' | 'OdfYaml' | 'Parquet' | 'ParquetJson', required
- `include` string

## Response `200`

- QueryResponse
  - `commitment` Commitment
    - `inputHash` string, required
    - `outputHash` string, required
    - `subQueriesHash` string, required
  - `input` QueryRequest
    - `dataFormat` 'JsonAoS' | 'JsonSoA' | 'JsonAoA'
    - `datasets` DatasetState[], nullable — Optional information used to affix an alias to the specific [`odf::DatasetID`] and reproduce the query at a specific state in time
      - `alias` string, required — Alias to be used in the query
      - `blockHash` string
      - `id` string, required
    - `include` Include[] — What information to include
    - `limit` integer — Pagination: limits number of records in response to N
    - `query` string, required — Query string
    - `queryDialect` 'SqlDataFusion' | 'SqlFlink' | 'SqlRisingWave' | 'SqlSpark'
    - `schemaFormat` 'ArrowJson' | 'OdfJson' | 'OdfYaml' | 'Parquet' | 'ParquetJson'
    - `skip` integer — Pagination: skips first N records
  - `output` Outputs, required
    - `data` unknown, required
    - `dataFormat` 'JsonAoS' | 'JsonSoA' | 'JsonAoA', required
    - `schema` Schema
    - `schemaFormat` 'ArrowJson' | 'OdfJson' | 'OdfYaml' | 'Parquet' | 'ParquetJson'
  - `proof` Proof
    - `proofValue` string, required
    - `type` 'Ed25519Signature2020', required
    - `verificationMethod` string, required
  - `subQueries` SubQuery[], nullable — Information about processing performed by other nodes as part of this operation
    - `commitment` Commitment, required
      - `inputHash` string, required
      - `outputHash` string, required
      - `subQueriesHash` string, required
    - `input` QueryRequest, required
      - `dataFormat` 'JsonAoS' | 'JsonSoA' | 'JsonAoA'
      - `datasets` DatasetState[], nullable — Optional information used to affix an alias to the specific [`odf::DatasetID`] and reproduce the query at a specific state in time
        - `alias` string, required — Alias to be used in the query
        - `blockHash` string
        - `id` string, required
      - `include` Include[] — What information to include
      - `limit` integer — Pagination: limits number of records in response to N
      - `query` string, required — Query string
      - `queryDialect` 'SqlDataFusion' | 'SqlFlink' | 'SqlRisingWave' | 'SqlSpark'
      - `schemaFormat` 'ArrowJson' | 'OdfJson' | 'OdfYaml' | 'Parquet' | 'ParquetJson'
      - `skip` integer — Pagination: skips first N records
    - `proof` Proof, required
      - `proofValue` string, required
      - `type` 'Ed25519Signature2020', required
      - `verificationMethod` string, required
    - `subQueries` object, required — Information about processing performed by other nodes as part of this operation

## Changes

- **2025-08-03** `411fe35264fd` — 6 warning, 2 info
  - added the new `OdfJson` enum value to the `input/schemaFormat` response property for the response status `200`
  - added the new `OdfJson` enum value to the `output/schemaFormat` response property for the response status `200`
  - added the new `OdfJson` enum value to the `subQueries/items/input/schemaFormat` response property for the response status `200`
  - added the new `OdfYaml` enum value to the `input/schemaFormat` response property for the response status `200`
  - …4 more
- **2025-07-29** `9aea0047e18e` — 2 breaking, 8 info
  - removed the enum value `OdfJson` from the `query` request parameter `schemaFormat`
  - removed the enum value `OdfYaml` from the `query` request parameter `schemaFormat`
  - removed the `EcdsaSecp256k1Signature2019` enum value from the `proof/type` response property for the response status `200`
  - removed the `EcdsaSecp256k1Signature2019` enum value from the `subQueries/items/proof/type` response property for the response status `200`
  - …6 more

[Change history](https://skmtc.dev/kamu-data/apis/kamu-rest-api/changes/query/get.md)

---

[API](https://skmtc.dev/kamu-data/apis/kamu-rest-api.md) · [All operations](https://skmtc.dev/kamu-data/apis/kamu-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kamu-data/kamu-rest-api/revisions/249ce4c8fd2f/schema)