Basic query structure

To create an SDMX query, a list of keys and parameters must be supplied in an URL in the following format. The available endpoints are classified into two groups — one for querying datasets from the Key Indicators Database, and the other for retrieving relevant metadata.

Dataset endpointv3

SDMX queries for this database consist of the following URL structure:

GET https://kidb.adb.org/api/v3/sdmx/data/{dataflow_id}/{sdmx_key}?{optionalParameters}

Parameter	Use
dataflow_id	Dataflows are assigned thematic category/grouping per indicator. The list of dataflows can be accessed using the dataflow endpoint. The list of indicators under each dataflow can be accessed using the indicators codelist.
sdmx_key	Format: FREQUENCY.INDICATOR_CODE(S).ECONOMY_CODE(S) We use the value `A` (annual) for FREQUENCY Dimensions should be separated by a period (`.`) For each dimension, its values should be separated by the plus sign (`+`). To return results for all relevant economies, use `ALL` as the economy code. If for a particular dimension, no dimension value identifiers are specified, then all available values of this dimension will be returned. To get the list of indicator keys and dimension values, refer to the downloadable metadata codelist and endpoints, described in the succeeding section .
optionalParameters	startPeriod	Specify the starting year of resulting data. From year `2000` onwards.
	endPeriod	Specify the ending year of resulting data. Up to year `2023`.
	format	The default format is SDMX-ML (XML). To get results in structure-specific or compact format, include `format=compact`.
	output_format	To view the results in SDMX-JSON format, include parameter `output_format=JSON` To view the results in SDMX-CSV format, include parameter `output_format=CSV`
	page	Page to be retrieved. If not specified, the first page will be shown
	per_page	Specify number of indicator series to be returned per page. If not specified, the default value of `25` indicator series per page will be shown.

Metadata endpointsv3

To view the metadata endpoints in standard JSON format, include the parameter at the end of the URL: ?output_format=JSON

Dataflow

Retrieves information of available dataflows

GET https://kidb.adb.org/api/v3/sdmx/metadata/dataflow

Retrieves information and list of indicators under a specific dataflow

GET https://kidb.adb.org/api/v3/sdmx/metadata/dataflow/{dataflow_id}

Data Structure Definition (DSD)

Retrieves the DSD for the KIDB dataset

GET https://kidb.adb.org/api/v3/sdmx/metadata/datastructure

Concept Scheme

Retrieves the concepts for the KIDB dataset

GET https://kidb.adb.org/api/v3/sdmx/metadata/conceptscheme

Code List

Retrieves the code lists for the KIDB dataset

GET https://kidb.adb.org/api/v3/sdmx/metadata/codelist

Download codelist in Excel spreadsheet format:

KIDB SDMX API Codelist XLSX

Statistics by Economy

SDMX API

Basic query structure

Dataset endpointv3

1. Query all indicator series under the National Accounts (EO_NA) dataflow for all economies using the default pagination values.

2. Query NGDP_XDC indicator series under the National Accounts (EO_NA) dataflow for Philippines (PHI) using the default pagination values.

3. Query NGDP_XDC and NGDPVA_XDC indicator series under the National Accounts (EO_NA) dataflow for Philippines, Singapore, and Japan using the default pagination values.

4. Query NGDP_XDC and NGDPVA_XDC indicator series under the National Accounts (EO_NA) dataflow for Philippines, Singapore, and Japan from years 2000 to 2005 using the default pagination values.

1. SDMX-ML format

2. SDMX-ML Compact format

3. SDMX-JSON format

4. SDMX-CSV format

1. Paginate the results and return only 3 indicator series per page.

2. Paginate the results and return only 3 indicator series per page. Retrieve the second page.

Metadata endpointsv3

Dataflow

Data Structure Definition (DSD)

Concept Scheme

Code List

About Key Indicators

ADB Publications

ADB Databases