> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lapathoniia.top/llms.txt
> Use this file to discover all available pages before exploring further.

# Derzhstat

> Official Ukrainian statistics via SDMX API

<Tabs sync={false}>
  <Tab title="EN">
    ## What is the Держстат connector?

    Direct access to [stat.gov.ua](https://stat.gov.ua/) SDMX API — 119 official Ukrainian statistics datasets.

    ## Quick Start

    Enable the connector (+ → Держстат) and type:

    ```
    Show all dataflows
    ```

    You get a list of 119 available datasets with IDs and names.

    ## Query Examples

    ```
    Birth rate in Ukraine
    Migration statistics 2023-2024
    Consumer price index by month
    GDP by region
    Capital investments 2022-2024
    ```

    ## Working Datasets

    | ID | Content | Status |
    | - | - | - |
    | `DF_SUPPLY_USE_ENERGY` | Energy supply & use | ✅ |
    | `DF_EXTERNAL_TRADE_OF_GOODS` | Foreign trade | ✅ |
    | `DF_PRICE_CHANGE_CONSUMER_GOODS_SERVICE` | Consumer price index | ✅ |
    | `DF_REGIONAL_ACCOUNTS` | GDP by region | ✅ |
    | `DF_POPULATION_MORTALITY` | Mortality | ✅ |
    | `DF_POPULATION_BIRTH` | Birth rate | ✅ |
    | `DF_POPULATION_MIGRATION` | Migration | ✅ |
    | `DF_CAPITAL_INVESTMENTS_A` | Capital investments | ✅ |

    ## Known Limitations

    <Warning>
      Some datasets are temporarily unavailable due to Держстат server limitations:

      * `DF_AREA_HARVESTS_CROP_YIELD_A/M` — crop harvest (stream abort on server)
      * `DF_AVAILABILITY_OF_GRAIN_AT_ENTERPRISES` — grain at enterprises

      For crop harvest queries (wheat, sunflower etc.), the connector **automatically falls back to web search** and finds data from Minahro press releases.
    </Warning>

    ## Direct Dataset Query

    If you know the dataset code:

    ```
    Get data from DF_POPULATION_BIRTH
    What is structure of DSD_EXTERNAL_TRADE_OF_GOODS?
    Show codelist CL_SUPPLY_USE_ENERGY_INDICATOR
    ```

    ## Code Formula

    For dataset named `NAME`:

    * Data: `DF_NAME`
    * Structure: `DSD_NAME`
    * Dimension codelist: `CL_NAME_DIMENSION`
  </Tab>

  <Tab title="UA">
    ## Quick Start

    Увімкніть конектор (+ → Держстат) і напишіть:

    ```
    Покажи список всіх датафлоу
    ```

    Отримаєте перелік 119 датасетів з ID та назвами.

    ## Query Examples

    ```
    Яка народжуваність в Україні?
    Статистика міграції 2023-2024
    Індекс споживчих цін по місяцях
    ВВП по регіонах
    Капітальні інвестиції 2022-2024
    ```

    ## Known Limitations

    <Warning>
      Деякі датасети тимчасово недоступні:

      * `DF_AREA_HARVESTS_CROP_YIELD_A/M` — врожай культур
      * `DF_AVAILABILITY_OF_GRAIN_AT_ENTERPRISES` — зерно на підприємствах

      Для запитів про врожай конектор **автоматично перемикається на веб-пошук** і знаходить дані з прес-релізів Мінагро.
    </Warning>

    ## Direct Dataset Query

    ```
    Отримай дані з DF_POPULATION_BIRTH
    Яка структура DSD_EXTERNAL_TRADE_OF_GOODS?
    Покажи кодлист CL_SUPPLY_USE_ENERGY_INDICATOR
    ```
  </Tab>
</Tabs>
