IMF DataMapper API documentation

The IMF DataMapper API can be used to retrieve time series as used in the DataMapper. Endpoints are available to get lists of indicators, countries, regions and analytical groups used in these time series.

The current version of the API is v1.

Available base endpoints

• - list of available indicators
• - list of countries;
• - list of defined geographical regions;
• - list of defined analytical groups.

Each of these will return a JSON object with the label and optionally additional information per item. The keys of the objects are the ID's to be used when retrieving time series.

Retrieving time series

Time series consist of an indicator ID and zero or more ID's for specific countries, regions and groups. These can be appended in any order to the base URL of the API.

It is possible to restrict the time series to a more specific period using the periods querystring parameter. This should be set to a comma separated list of requested years.

Examples

• - retrieve all values for Real GDP Growth;
• - retrieve Real GDP Growth values for the United States and the People's Republic of China;
• - retrieve Real GDP Growth values for 2019 and 2020.