Skip to content

SDMX 2.0 RESTFUL WEB SERVICE

The Data Service can be used as SDMX 2.0 RESTFUL.

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

These URL is given as examples and may be different on the concrete server.

The JSON RESTful Web Service exposes the following methods:

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

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:

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

1.2 DataStructure Method

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

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

1.3 CompactData Method

CompactData method returns the compact data message.
In order to obtain the data use the following 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}

1.4 MetadataStructure Method

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

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

1.5 GenericMetadata Method

GenericMetadata method returns the generic metadata message.
In order to obtain the data use the following 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}

1.6 CodeList Method 

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

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

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