SDMX 2.0 AND SDMX 2.1 RESTFUL WEB SERVICE

The start point to the service located in the following URL: http://dataservices.imf.org/REST/SDMX_XML.svc .

The URLs below are given as examples and may be different on the concrete server.

The SDMX RESTful Web Service exposes the following methods:

• Dataflow
• DataStructure
• CompactData
• MetadataStructure
• GenericMetadata
• CodeList
• MaxSeriesInResult  

The default response will be provided in SDMX 2.0 format. To receive the response in SDMX 2.1 format, please append the parameter “format” with the value “sdmx-2.1. See examples provided below.

1.1 Dataflow Method

Dataflow method returns the list of the datasets, registered for the Data Service.
In order to obtain the data use the following request:

SDMX 2.0 Request: 

http://dataservices.imf.org/REST/SDMX_XML.svc/Dataflow

SDMX 2.1 Request:

http://dataservices.imf.org/REST/SDMX_XML.svc/Dataflow?format=sdmx-2.1

1.2 DataStructure Method

DataStructure method returns the structure of the dataset.

In order to obtain the data use the following request:

SDMX 2.0 Request:

http://dataservices.imf.org/REST/SDMX_XML.svc/DataStructure/{database ID}

SDMX 2.1 Request:

http://dataservices.imf.org/REST/SDMX_XML.svc/DataStructure/{database ID}
?format=sdmx-2.1

1.3 CompactData Method


CompactData method returns the compact data message.
In order to obtain the data use the following request: 

SDMX 2.0 Request:

http://dataservices.imf.org/REST/SDMX_XML.svc/CompactData/{database ID}/{item1 from

dimension1}+{item2 from dimension1}+{item N from dimension1}.{item1 from

dimension2}+{item2 from dimension2}+{item M from dimension2}?startPeriod={start

date}&endPeriod={end date}

SDMX 2.1 Request:

http://dataservices.imf.org/REST/SDMX_XML.svc/CompactData/{database ID}/{item1 from

dimension1}+{item2 from dimension1}+{item N from dimension1}.{item1 from

dimension2}+{item2 from dimension2}+{item M from dimension2}?startPeriod={start

date}&endPeriod={end date}&format=sdmx-2.1

1.4 MetadataStructure Method

MetadataStructure method returns the metadata structure of the dataset.
In order to obtain the data use the following request:  

SDMX 2.0 Request:

http://dataservices.imf.org/REST/SDMX_XML.svc/MetadataStructure/{database ID} 

SDMX 2.1 Request:

http://dataservices.imf.org/REST/SDMX_XML.svc/MetadataStructure/{database ID}

?fromat=sdmx-2.1

1.5 GenericMetadata Method

GenericMetadata method returns the generic metadata message.
In order to obtain the data use the following request: 

SDMX 2.0 Request:

http://dataservices.imf.org/REST/SDMX_XML.svc/GenericMetadata/{database ID}/{frequency}.{item1 from dimension1}+{item2 from

dimension1}+{item N from dimension1}.{item1 from dimension2}+{item2 from

dimension2}+{item M from dimension2}?startPeriod={start date}&endPeriod={end date}

SDMX 2.1 Request:

http://dataservices.imf.org/REST/SDMX_XML.svc/GenericMetadata/{database ID}/{frequency}.{item1 from dimension1}+{item2 from

dimension1}+{item N from dimension1}.{item1 from dimension2}+{item2 from

dimension2}+{item M from dimension2}?startPeriod={start date}&endPeriod={end date}&format=sdmx-2.1

1.6 CodeList Method

GetCodeList method returns the description of CodeLists
In order to obtain the data use the following request: 

SDMX 2.0 Request:

http://dataservices.imf.org/REST/SDMX_XML.svc/CodeList/{codelist code}/|{database ID}

SDMX 2.1 Request:

http://dataservices.imf.org/REST/SDMX_XML.svc/CodeList/{codelist code}/|

{database ID}?format=sdmx-2.1

1.7 MaxSeriesInResult Method

GetMaxSeriesInResult method returns the maximum number of time series that can be returned by CompactData.
In order to obtain the data use the following request:

http://dataservices.imf.org/REST/SDMX_XML.svc/GetMaxSeriesInResult

Feedback and Knowledge Base