Eurostat SDMX 2.1 API

SDMX 2.1-compliant web service providing access to Eurostat datasets and structural metadata in SDMX-ML (XML), SDMX-CSV, and TSV formats.

OpenAPI Specification

eurostat-sdmx-rest-openapi.yaml Raw ↑
openapi: 3.0.0
info:
  version: '1.0'
  title: 'Eurostat SDMX RESTful API'
  description: |
    Listing of supported SDMX requests based on
    * [official sdmx-rest 2.1 specifications](https://github.com/sdmx-twg/sdmx-rest/tree/v1.5.0/v2_1/ws/rest/docs)
    * [official sdmx-rest 3.0 specifications](https://github.com/sdmx-twg/sdmx-rest/tree/v2.0.0/doc)

    For additional information, please consult the [online-help](https://ec.europa.eu/eurostat/web/user-guides/data-browser).

  contact:
    name: Contact Eurostat user support
    url: https://ec.europa.eu/eurostat/help/support

tags:
  - name: SDMX 2.1 Data queries
  - name: SDMX 2.1 Structure queries
  - name: SDMX 2.1 Navigation Structure queries
  - name: SDMX 3.0 Data queries
  - name: SDMX 3.0 Structure queries
  - name: Async
    description: asynchronous processing
    externalDocs:
      url: https://ec.europa.eu/eurostat/web/user-guides/data-browser/api-data-access/api-detailed-guidelines/asynchronous-api
servers:
  - description: Eurostat
    url: https://ec.europa.eu/eurostat/api/dissemination
  - description: Eurostat - Comext datasets
    url: https://ec.europa.eu/eurostat/api/comext/dissemination
paths:
  /sdmx/2.1/data/{flow}/{key}:
    get:
      summary: 'Get data'
      tags:
        - SDMX 2.1 Data queries
      parameters:
        - $ref: '#/components/parameters/flow'
        - $ref: '#/components/parameters/key'
        - $ref: '#/components/parameters/startPeriod'
        - $ref: '#/components/parameters/endPeriod'
        - $ref: '#/components/parameters/firstNObservations'
        - $ref: '#/components/parameters/lastNObservations'
        - $ref: '#/components/parameters/dimensionAtObservation'
        - $ref: '#/components/parameters/detail'
        - $ref: '#/components/parameters/accept-encoding'
        - $ref: '#/components/parameters/accept-language'
      responses:
        '200':
          $ref: '#/components/responses/200'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'

  /sdmx/3.0/data/dataflow/{agencyID}/{resourceID}/{version}:
    get:
      summary: 'Get data'
      tags:
        - SDMX 3.0 Data queries
      parameters:
        - $ref: '#/components/parameters/agencyID'
        - $ref: '#/components/parameters/resourceID'
        - $ref: '#/components/parameters/version3.0'
        - $ref: '#/components/parameters/c'
        - $ref: '#/components/parameters/attributes'
        - $ref: '#/components/parameters/measures'
        - $ref: '#/components/parameters/format_data3.0'
        - $ref: '#/components/parameters/formatversion_data3.0'
        - $ref: '#/components/parameters/lang_data3.0'
        - $ref: '#/components/parameters/labels'
        - $ref: '#/components/parameters/compress'
        - $ref: '#/components/parameters/accept-encoding'
        - $ref: '#/components/parameters/accept-language'
      responses:
        '200':
          $ref: '#/components/responses/200-sdmx3.0'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'

  /sdmx/3.0/data/dataflow/{agencyID}/{resourceID}/{version}/{key}:
    get:
      summary: 'Get data'
      tags:
        - SDMX 3.0 Data queries
      parameters:
        - $ref: '#/components/parameters/agencyID'
        - $ref: '#/components/parameters/resourceID'
        - $ref: '#/components/parameters/version3.0'
        - $ref: '#/components/parameters/key3.0'
        - $ref: '#/components/parameters/c'
        - $ref: '#/components/parameters/attributes'
        - $ref: '#/components/parameters/measures'
        - $ref: '#/components/parameters/format_data3.0'
        - $ref: '#/components/parameters/formatversion_data3.0'
        - $ref: '#/components/parameters/lang_data3.0'
        - $ref: '#/components/parameters/labels'
        - $ref: '#/components/parameters/compress'
        - $ref: '#/components/parameters/accept-encoding'
        - $ref: '#/components/parameters/accept-language'
      responses:
        '200':
          $ref: '#/components/responses/200-sdmx3.0'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'

  /sdmx/2.1/dataflow/{agencyID}/{resourceID}/{version}:
    get:
      summary: 'Get dataflows'
      tags:
        - SDMX 2.1 Structure queries
      parameters:
        - $ref: '#/components/parameters/agencies'
        - $ref: '#/components/parameters/resourceIDs'
        - $ref: '#/components/parameters/versions'
        - $ref: '#/components/parameters/references'
        - $ref: '#/components/parameters/structDetail'
        - $ref: '#/components/parameters/accept-encoding'
        - $ref: '#/components/parameters/accept-language'
      responses:
        '200':
          $ref: '#/components/responses/200-struct'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'

  /sdmx/2.1/contentconstraint/{agencyID}/{resourceID}/{version}:
    get:
      summary: 'Get content constraints'
      tags:
        - SDMX 2.1 Structure queries
      parameters:
        - $ref: '#/components/parameters/agencies'
        - $ref: '#/components/parameters/resourceIDs'
        - $ref: '#/components/parameters/versions'
        - $ref: '#/components/parameters/references'
        - $ref: '#/components/parameters/structDetail'
        - $ref: '#/components/parameters/accept-encoding'
        - $ref: '#/components/parameters/accept-language'
      responses:
        '200':
          $ref: '#/components/responses/200-struct'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'

  /sdmx/2.1/datastructure/{agencyID}/{resourceID}/{version}:
    get:
      summary: 'Get data structures'
      tags:
        - SDMX 2.1 Structure queries
      parameters:
        - $ref: '#/components/parameters/agencies'
        - $ref: '#/components/parameters/resourceIDs'
        - $ref: '#/components/parameters/versions'
        - $ref: '#/components/parameters/references'
        - $ref: '#/components/parameters/structDetail'
        - $ref: '#/components/parameters/accept-encoding'
        - $ref: '#/components/parameters/accept-language'
      responses:
        '200':
          $ref: '#/components/responses/200-struct'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'



  /sdmx/2.1/conceptscheme/{agencyID}/{resourceID}/{version}:
    get:
      summary: 'Get concept schemes'
      tags:
        - SDMX 2.1 Structure queries
      parameters:
        - $ref: '#/components/parameters/agencies'
        - $ref: '#/components/parameters/resourceIDs'
        - $ref: '#/components/parameters/versions'
        - $ref: '#/components/parameters/references'
        - $ref: '#/components/parameters/structDetail'
        - $ref: '#/components/parameters/accept-encoding'
        - $ref: '#/components/parameters/accept-language'
      responses:
        '200':
          $ref: '#/components/responses/200-struct'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'

  /sdmx/2.1/codelist/{agencyID}/{resourceID}/{version}:
    get:
      summary: 'Get codelists'
      tags:
        - SDMX 2.1 Structure queries
      parameters:
        - $ref: '#/components/parameters/agencies'
        - $ref: '#/components/parameters/resourceIDs'
        - $ref: '#/components/parameters/versions'
        - $ref: '#/components/parameters/references'
        - $ref: '#/components/parameters/structDetail'
        - $ref: '#/components/parameters/accept-encoding'
        - $ref: '#/components/parameters/accept-language'
      responses:
        '200':
          $ref: '#/components/responses/200-struct'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'
  /sdmx/3.0/structure/dataflow/{agencyID}/{resourceID}:
    get:
      summary: 'Get dataflows'
      tags:
        - SDMX 3.0 Structure queries
      description: |
        Structure queries allow **retrieving structural metadata**.

        Dataflow structure queries in SDMX allow you to retrieve structural metadata available from the 'dataflow' of a particular dataset.

      parameters:
        - $ref: '#/components/parameters/agencyID'
        - $ref: '#/components/parameters/resourceID'
        - $ref: '#/components/parameters/references_n_c_d'
        - $ref: '#/components/parameters/structDetail3.0_dataflow'
        - $ref: '#/components/parameters/format_struct3.0'
        - $ref: '#/components/parameters/formatversion_struct3.0'
        - $ref: '#/components/parameters/compress'
        - $ref: '#/components/parameters/accept-encoding'
        - $ref: '#/components/parameters/accept-language'
      responses:
        '200':
          $ref: '#/components/responses/200-struct-sdmx3.0'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'
  /sdmx/3.0/structure/dataflow/{agencyID}/{resourceID}/{version}:
    get:
      summary: 'Get dataflows'
      tags:
        - SDMX 3.0 Structure queries
      description: |
        Structure queries allow **retrieving structural metadata**.

        Dataflow structure queries in SDMX allow you to retrieve structural metadata available from the 'dataflow' of a particular dataset.

      parameters:
        - $ref: '#/components/parameters/agencyID'
        - $ref: '#/components/parameters/resourceID'
        - $ref: '#/components/parameters/version-struct3.0'
        - $ref: '#/components/parameters/references_n_c_d'
        - $ref: '#/components/parameters/structDetail3.0_dataflow'
        - $ref: '#/components/parameters/format_struct3.0'
        - $ref: '#/components/parameters/formatversion_struct3.0'
        - $ref: '#/components/parameters/compress'
        - $ref: '#/components/parameters/accept-encoding'
        - $ref: '#/components/parameters/accept-language'
      responses:
        '200':
          $ref: '#/components/responses/200-struct-sdmx3.0'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'
  /sdmx/3.0/structure/dataconstraint/{agencyID}/{resourceID}:
    get:
      summary: 'Get dataconstraints'
      tags:
        - SDMX 3.0 Structure queries
      description: |
        Structure queries allow **retrieving structural metadata**.

        Dataconstraint structure queries in SDMX allow you to retrieve structural metadata available from the 'dataconstraint' of a particular dataset.
      parameters:
        - $ref: '#/components/parameters/agencyID'
        - $ref: '#/components/parameters/resourceID'
        - $ref: '#/components/parameters/references_n'
        - $ref: '#/components/parameters/structDetail3.0'
        - $ref: '#/components/parameters/format_struct3.0'
        - $ref: '#/components/parameters/formatversion_struct3.0'
        - $ref: '#/components/parameters/compress'
        - $ref: '#/components/parameters/accept-encoding'
        - $ref: '#/components/parameters/accept-language'
      responses:
        '200':
          $ref: '#/components/responses/200-struct-sdmx3.0'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'
  /sdmx/3.0/structure/dataconstraint/{agencyID}/{resourceID}/{version}:
    get:
      summary: 'Get dataconstraints'
      tags:
        - SDMX 3.0 Structure queries
      description: |
        Structure queries allow **retrieving structural metadata**.

        Dataconstraint structure queries in SDMX allow you to retrieve structural metadata available from the 'dataconstraint' of a particular dataset.
      parameters:
        - $ref: '#/components/parameters/agencyID'
        - $ref: '#/components/parameters/resourceID'
        - $ref: '#/components/parameters/version-struct3.0'
        - $ref: '#/components/parameters/references_n'
        - $ref: '#/components/parameters/structDetail3.0'
        - $ref: '#/components/parameters/format_struct3.0'
        - $ref: '#/components/parameters/formatversion_struct3.0'
        - $ref: '#/components/parameters/compress'
        - $ref: '#/components/parameters/accept-encoding'
        - $ref: '#/components/parameters/accept-language'
      responses:
        '200':
          $ref: '#/components/responses/200-struct-sdmx3.0'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'
  /sdmx/3.0/structure/datastructure/{agencyID}/{resourceID}:
    get:
      summary: 'Get datastructure'
      tags:
        - SDMX 3.0 Structure queries
      description: |
        Structure queries allow **retrieving structural metadata**.

        Datastructure queries in SDMX allow you to retrieve structural metadata available from the 'datastructure' of a particular dataset.
      parameters:
        - $ref: '#/components/parameters/agencyID'
        - $ref: '#/components/parameters/resourceID'
        - $ref: '#/components/parameters/references'
        - $ref: '#/components/parameters/structDetail3.0'
        - $ref: '#/components/parameters/format_struct3.0'
        - $ref: '#/components/parameters/formatversion_struct3.0'
        - $ref: '#/components/parameters/compress'
        - $ref: '#/components/parameters/accept-encoding'
        - $ref: '#/components/parameters/accept-language'
      responses:
        '200':
          $ref: '#/components/responses/200-struct-sdmx3.0'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'
  /sdmx/3.0/structure/datastructure/{agencyID}/{resourceID}/{version}:
    get:
      summary: 'Get datastructure'
      tags:
        - SDMX 3.0 Structure queries
      description: |
        Structure queries allow **retrieving structural metadata**.

        Datastructure queries in SDMX allow you to retrieve structural metadata available from the 'datastructure' of a particular dataset.
      parameters:
        - $ref: '#/components/parameters/agencyID'
        - $ref: '#/components/parameters/resourceID'
        - $ref: '#/components/parameters/version-struct3.0'
        - $ref: '#/components/parameters/references'
        - $ref: '#/components/parameters/structDetail3.0'
        - $ref: '#/components/parameters/format_struct3.0'
        - $ref: '#/components/parameters/formatversion_struct3.0'
        - $ref: '#/components/parameters/compress'
        - $ref: '#/components/parameters/accept-encoding'
        - $ref: '#/components/parameters/accept-language'
      responses:
        '200':
          $ref: '#/components/responses/200-struct-sdmx3.0'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'
  /sdmx/3.0/structure/conceptscheme/{agencyID}/{resourceID}:
    get:
      summary: 'Get conceptscheme'
      tags:
        - SDMX 3.0 Structure queries
      description: |
        Structure queries allow **retrieving structural metadata**.

        Conceptscheme queries in SDMX allow you to retrieve structural metadata available from a particular 'conceptscheme'.
      parameters:
        - $ref: '#/components/parameters/agencyID'
        - $ref: '#/components/parameters/resourceID'
        - $ref: '#/components/parameters/references_n_p_ps'
        - $ref: '#/components/parameters/structDetail3.0'
        - $ref: '#/components/parameters/format_struct3.0'
        - $ref: '#/components/parameters/formatversion_struct3.0'
        - $ref: '#/components/parameters/compress'
        - $ref: '#/components/parameters/accept-encoding'
        - $ref: '#/components/parameters/accept-language'
      responses:
        '200':
          $ref: '#/components/responses/200-struct-sdmx3.0'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'
  /sdmx/3.0/structure/conceptscheme/{agencyID}/{resourceID}/{version}:
    get:
      summary: 'Get conceptscheme'
      tags:
        - SDMX 3.0 Structure queries
      description: |
        Structure queries allow **retrieving structural metadata**.

        Conceptscheme queries in SDMX allow you to retrieve structural metadata available from a particular 'conceptscheme'.
      parameters:
        - $ref: '#/components/parameters/agencyID'
        - $ref: '#/components/parameters/resourceID'
        - $ref: '#/components/parameters/version-struct3.0'
        - $ref: '#/components/parameters/references_n_p_ps'
        - $ref: '#/components/parameters/structDetail3.0'
        - $ref: '#/components/parameters/format_struct3.0'
        - $ref: '#/components/parameters/formatversion_struct3.0'
        - $ref: '#/components/parameters/compress'
        - $ref: '#/components/parameters/accept-encoding'
        - $ref: '#/components/parameters/accept-language'
      responses:
        '200':
          $ref: '#/components/responses/200-struct-sdmx3.0'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'
  /sdmx/3.0/structure/codelist/{agencyID}/{resourceID}:
    get:
      summary: 'Get codelist'
      tags:
        - SDMX 3.0 Structure queries
      description: |
        Structure queries allow **retrieving structural metadata**.

        Codelist structure queries in SDMX allow you to retrieve structural metadata available from a particular 'codelist'.
      parameters:
        - $ref: '#/components/parameters/agencyID'
        - $ref: '#/components/parameters/resourceID'
        - $ref: '#/components/parameters/references_n_p_ps'
        - $ref: '#/components/parameters/structDetail3.0'
        - $ref: '#/components/parameters/format_struct3.0'
        - $ref: '#/components/parameters/formatversion_struct3.0'
        - $ref: '#/components/parameters/compress'
        - $ref: '#/components/parameters/accept-encoding'
        - $ref: '#/components/parameters/accept-language'
      responses:
        '200':
          $ref: '#/components/responses/200-struct-sdmx3.0'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'
  /sdmx/3.0/structure/codelist/{agencyID}/{resourceID}/{version}:
    get:
      summary: 'Get codelist'
      tags:
        - SDMX 3.0 Structure queries
      description: |
        Structure queries allow **retrieving structural metadata**.

        Codelist structure queries in SDMX allow you to retrieve structural metadata available from a particular 'codelist'.
      parameters:
        - $ref: '#/components/parameters/agencyID'
        - $ref: '#/components/parameters/resourceID'
        - $ref: '#/components/parameters/version-struct3.0'
        - $ref: '#/components/parameters/references_n_p_ps'
        - $ref: '#/components/parameters/structDetail3.0'
        - $ref: '#/components/parameters/format_struct3.0'
        - $ref: '#/components/parameters/formatversion_struct3.0'
        - $ref: '#/components/parameters/compress'
        - $ref: '#/components/parameters/accept-encoding'
        - $ref: '#/components/parameters/accept-language'
      responses:
        '200':
          $ref: '#/components/responses/200-struct-sdmx3.0'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'
  /sdmx/2.1/categoryscheme/{agencyID}/{resourceID}/{version}:
    get:
      summary: 'Get category schemes'
      tags:
        - SDMX 2.1 Navigation Structure queries
      parameters:
        - $ref: '#/components/parameters/agencies'
        - $ref: '#/components/parameters/resourceIDs'
        - $ref: '#/components/parameters/versions'
        - $ref: '#/components/parameters/references'
        - $ref: '#/components/parameters/structDetail'
        - $ref: '#/components/parameters/accept-encoding'
        - $ref: '#/components/parameters/accept-language'
      responses:
        '200':
          $ref: '#/components/responses/200-struct'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'

  /sdmx/2.1/categorisation/{agencyID}/{resourceID}/{version}:
    get:
      summary: 'Get categorisations'
      tags:
        - SDMX 2.1 Navigation Structure queries
      parameters:
        - $ref: '#/components/parameters/agencies'
        - $ref: '#/components/parameters/resourceIDs'
        - $ref: '#/components/parameters/versions'
        - $ref: '#/components/parameters/references'
        - $ref: '#/components/parameters/structDetail'
        - $ref: '#/components/parameters/accept-encoding'
        - $ref: '#/components/parameters/accept-language'
      responses:
        '200':
          $ref: '#/components/responses/200-struct'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'

  /1.0/async/status/{uuid}:
    get:
      operationId: getAsyncStatus
      description: The status of a request that is processed asynchronously can be checked
      tags:
        - Async
      parameters:
        - $ref: '#/components/parameters/uuid'
      responses:
        '200':
          description: >-
            The status of a request that is processed asynchronously can be one of the following values:

            * SUBMITTED -  the request is submitted for processing

            * PROCESSING -  the request is currently being processed

            * AVAILABLE - the data is available for download

            * EXPIRED - the request was processed but the data is no longer available (cache expired)
          content:
            application/xml:
              schema:
                type: string
              examples:
 

# --- truncated at 32 KB (67 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/eurostat/refs/heads/main/openapi/eurostat-sdmx-rest-openapi.yaml