---
title: "Filtered time series"
method: GET
path: "/api/datasets/{id}/data"
tags: ["Datasets"]
---

# Filtered time series

`GET /api/datasets/{id}/data`

## Request

- Base URL: `https://monit.ly`
- URL: `https://monit.ly/api/datasets/{id}/data`
- Auth: API key in header `X-API-Key`

Filter by dimension labels (dim1..dim8, exact and case-sensitive), countries and periods.
Repeat a parameter for multiple values, e.g. `country=Austria&country=Poland`.
Periods use the dataset format: `1995`, `Q1/1995`, `01/2000` (URL-encode slashes).

## Path parameters

- `id` integer, required

## Query parameters

- `dim1` string[]
- `dim2` string[]
- `dim3` string[]
- `dim4` string[]
- `dim5` string[]
- `dim6` string[]
- `dim7` string[]
- `dim8` string[]
- `country` string[]
- `period` string
- `period_from` string
- `period_to` string
- `latest` boolean
- `followed` boolean

## Response `200`

Filtered series with metadata

- object
  - `data` SeriesBlock[]
    - `series_key` object
    - `countries` string[]
    - `rows` object[]
      - `period` string
      - `values` object
      - `unit` string
  - `meta` DatasetMeta
    - `id` integer
    - `dataset_code` string
    - `dataset_name` string
    - `description` string
    - `source_name` string
    - `source_url` string
    - `metadata_url` string
    - `version` string
    - `oldest_period` string
    - `latest_period` string
    - `last_update` string
    - `available_geo` string[]

## Other responses

- `400`: Invalid parameters
- `404`: Dataset not found
- `429`: Daily limit exceeded (resets at midnight UTC)

---

[API](https://skmtc.dev/monitly/apis/monitly-api.md) · [All operations](https://skmtc.dev/monitly/apis/monitly-api/llms.txt) · [OpenAPI document](https://skmtc.dev/monitly/apis/monitly-api/revisions/87330898d3a6?raw)