The SDMX API is used to provide programmatic access to datasets available on the State Statistics Service distribution portal, namely data structures, data and metadata. Access is provided via the REST protocol, with the ability to retrieve artifacts in JSON and XML formats.
SDMX API v3
The SDMX 3.0 technical specification was adopted in September 2021. Compared to the SDMX version, API 2.1 provides access to a larger list of structural artifacts. The full list of changes is available in English by this link.
SDMX API v2.1
The SDMX 2.1 technical specification was adopted in April 2012. The goal of version 2.1 is to make it simple to run a limited set of standard queries. Also, unlike other parts of the SDMX specification, the RESTful API focuses exclusively on retrieving data (via HTTP GET).
Step-by-Step Usage Example for SDMX API
This page provides step-by-step instructions for retrieving structural elements and data via the SDMX API of the State Statistics Service of Ukraine. You will learn how to:
- obtain a list of all available dataflows along with their metadata and descriptions;
- view the data structure (DSD) for a selected dataflow, including the list and order of dimensions and attributes;
- explore concept schemes and codelists that define possible values for dimensions;
- retrieve the values of a specific codelist with translations;
- construct a request to obtain actual data (time series) in SDMX format.
Each step is accompanied by a Examples of queries and an explanation of how to interpret the server response. This allows you to quickly navigate the data structure and build your own queries for system integration or analytics.