---
title: "Execute a data query"
method: POST
path: "/data/v1/query"
tags: ["Data"]
---

# Execute a data query

`POST /data/v1/query`

Execute a query against your minubo data.

Use `GET /data/v1/schema` first to discover the attributes and measures available for your account. The schema response contains the field `code` values that can be used in `attributes`, `measures`, filters, and ordering. Authenticate with `/auth/v1/token` and send the returned JWT as a Bearer token.

**Query limitations:**
- At most 20 `attributes` and 20 `measures` are allowed per request.
- `limit` must be between 0 and 200000.
- `timeFilter` is required, and its `from` must not be after its `to`. The same applies to `comparisonTimeFilter` when provided.
- `IN` and `NOT_IN` filters require a non-empty `values` list; `EXISTS` and `NOT_EXISTS` filters must not set `values`.
- `orderBy.field` must reference one of the fields declared in `attributes` or `measures`.

## Request body

- DataDataQueryRequest
  - `attributes` string[], required
  - `measures` string[], required
  - `timeFilter` DataDataQueryTimeFilterModel
    - `from` string, date
    - `to` string, date
  - `comparisonTimeFilter` DataDataQueryTimeFilterModel
    - `from` string, date
    - `to` string, date
  - `filter` DataDataQueryFilterEntry[], required
    - `attribute` string
    - `operator` 'IN' | 'NOT_IN' | 'EXISTS' | 'NOT_EXISTS'
    - `values` string[]
  - `orderBy` DataDataQueryOrderBy
    - `field` string
    - `direction` 'ASC' | 'DESC', required
  - `limit` integer, required

## Response `200`

Query executed successfully

- DataDataQueryResponse
  - `rows` DataDataQueryRow[], required
    - `attributes` object, required
    - `values` object, required
    - `comparison` object

## Other responses

- `400` — Invalid request
- `403` — Field not allowed
- `422` — Unprocessable query
- `500` — Unexpected internal error
- `504` — Backend timeout

---

[API](https://skmtc.net/minubo/apis/minubo-api.md) · [All operations](https://skmtc.net/minubo/apis/minubo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/minubo/minubo-api/revisions/66b01bd3abe6/schema)