Skip to content

JSON RESTful Web Service

The Data Service can be used as JSON RESTful.

The start point to the service located in the following URL: http://dataservices.imf.org/REST/SDMX_JSON.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_JSON.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_JSON.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_JSON.svc/CompactData/{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.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_JSON.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_JSON.svc/GenericMetadata/{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.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_JSON.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_JSON.svc/GetMaxSeriesInResult

 

Feedback and Knowledge Base