---
title: "GET /query"
method: GET
path: "/query"
---

# GET /query

`GET /query`

get data

## Query parameters

- `s` string, required
- `f` number, required
- `t` number, required
- `w` number, required
- `qw` QueryFn[], required
- `qv` 0 | 1
- `v` '1' | '2', required
- `n` number, required
- `qf` string[]
- `qb` string[]
- `g` string
- `ts` string[]
- `df` '' | 'csv'
- `ep` 1

## Response `200`

OK

- GetQueryResp
  - `series` QuerySeries, required
    - `time` number[], required
    - `series_meta` QuerySeriesMeta[], required
      - `time_shift` number, required
      - `tags` object, required
      - `max_hosts` string[], required
      - `what` 'count' | 'count_norm' | 'cu_count' | 'min' | 'max' | 'avg' | 'cu_avg' | 'sum' | 'sum_norm' | 'cu_sum' | 'stddev' | 'p25' | 'p50' | 'p75' | 'p90' | 'p95' | 'p99' | 'p999' | 'unique' | 'unique_norm' | 'max_host' | 'max_count_host' | 'dv_count' | 'dv_sum' | 'dv_avg' | 'dv_min' | 'dv_max' | 'dv_unique' | 'dv_unique_norm' | 'dv_count_norm' | 'dv_sum_norm', required
      - `total` number
    - `series_data` array[], required
      - number[]
  - `receive_errors` number
  - `receive_warnings` number
  - `sampling_factor_src` number
  - `sampling_factor_agg` number
  - `mapping_errors` number
  - `excess_point_left` boolean
  - `excess_point_right` boolean
  - `metric` MetricMetaValue
    - `metric_id` number
    - `namespace_id` integer, required
    - `name` string, required
    - `description` string
    - `tags` MetricMetaTag[]
      - `name` string
      - `description` string
      - `raw` boolean
      - `raw_kind` 'uint' | 'hex' | 'hex_bswap' | 'timestamp' | 'timestamp_local' | 'ip' | 'ip_bswap' | 'lexenc_float'
      - `id2value` object
      - `value_comments` object
    - `visible` boolean
    - `kind` 'counter' | 'value' | 'value_p' | 'unique' | 'mixed' | 'mixed_p', required
    - `weight` number
    - `resolution` number
    - `string_top_name` string
    - `string_top_description` string
    - `pre_key_tag_id` string
    - `pre_key_from` number
    - `update_time` number
    - `version` number
    - `group_id` number
    - `pre_key_only` boolean
    - `metric_type` string, required
    - `tags_draft` object
    - `fair_key_tag_ids` string[]

## Changes

- **2024-11-14** `c3656ac68ee3` — 3 warning
  - added the new `lexenc_float` enum value to the `metric/tags/items/raw_kind` response property for the response status `200`
  - added the new `lexenc_float` enum value to the `metric/tags_draft/additionalProperties/raw_kind` response property for the response status `200`
  - added the new `lexenc_float` enum value to the `series/series_meta/items/tags/additionalProperties/raw_kind` response property for the response status `200`
- **2024-08-20** `c866c961a09f` — 1 info
  - added the optional property `metric/fair_key_tag_ids` to the response with the `200` status
- **2024-03-29** `5a9e98813e91` — 4 info
  - added the new optional `query` request parameter `ep`
  - added the optional property `excess_point_left` to the response with the `200` status
  - added the optional property `excess_point_right` to the response with the `200` status
  - added the optional property `metric` to the response with the `200` status
- **2023-09-15** `5fa21d9cf00d` — 2 warning
  - removed the optional property `mapping_flood_events_legacy` from the response with the `200` status
  - removed the optional property `receive_errors_legacy` from the response with the `200` status
- **2023-05-12** `a37af921fc01` — 1 info
  - added the optional property `receive_warnings` to the response with the `200` status

[Full history](https://skmtc.dev/vkcom/apis/statshouse-openapi-3-0/changes/query/get.md)

---

[API](https://skmtc.dev/vkcom/apis/statshouse-openapi-3-0.md) · [All operations](https://skmtc.dev/vkcom/apis/statshouse-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vkcom/statshouse-openapi-3-0/revisions/c3656ac68ee3/schema)