{period}: Get data

API: imf.org:imf-data-api
Endpoint: /v1/data/{datasetCode}/{period}
Response format: application/json
Auth: none
Method: GET
Last Status: 403
Latency: 156ms

Description

Returns time series data for a specific economic indicator and country/region. Supports fetching historical data, projections, and multi-year time series.

From spec: Get IMF data for a specific dataset and period

Usage Tips

- datasetCode = indicator code from /indicators endpoint (e.g., NGDP_RPCH for real GDP growth) - period = year (e.g., 2020) or omit for all available years - Use + to specify multiple countries (e.g., USA+DEU) or groups - Returns annual data typically from 1980 to 2030 (historical + projections)

Parameters (2)

datasetCode (string, path, required)

period (string, path, required)

Examples (3)

Get Real GDP Growth for United States (all years) probe-gate

Demonstrates fetching complete time series data for a specific indicator and country. Returns all available years from 1980 to projections through 2030.

curl 'https://www.imf.org/external/datamapper/api/v1/NGDP_RPCH/USA'

import requests

resp = requests.get("https://www.imf.org/external/datamapper/api/v1/NGDP_RPCH/USA")
data = resp.json()

import zingu_apis

api = zingu_apis.api("imf")
result = api.fetch("v1/data/{datasetCode}/{period}")

for item in result:
    print(item)

const resp = await fetch("https://www.imf.org/external/datamapper/api/v1/NGDP_RPCH/USA");
const data = await resp.json();

Truncate

Auto Table Raw

Get GDP Current Prices for specific year (2024) probe-gate

Demonstrates fetching a specific data point for a single year rather than the entire time series.

curl 'https://www.imf.org/external/datamapper/api/v1/NGDPD/USA/2024'

import requests

resp = requests.get("https://www.imf.org/external/datamapper/api/v1/NGDPD/USA/2024")
data = resp.json()

import zingu_apis

api = zingu_apis.api("imf")
result = api.fetch("v1/data/{datasetCode}/{period}")

for item in result:
    print(item)

const resp = await fetch("https://www.imf.org/external/datamapper/api/v1/NGDPD/USA/2024");
const data = await resp.json();

Truncate

Auto Table Raw

Get World Real GDP Growth (all years) probe-gate

Demonstrates fetching global economic data using the WEOWORLD group code to get world-level aggregates.

curl 'https://www.imf.org/external/datamapper/api/v1/NGDP_RPCH/WEOWORLD'

import requests

resp = requests.get("https://www.imf.org/external/datamapper/api/v1/NGDP_RPCH/WEOWORLD")
data = resp.json()

import zingu_apis

api = zingu_apis.api("imf")
result = api.fetch("v1/data/{datasetCode}/{period}")

for item in result:
    print(item)

const resp = await fetch("https://www.imf.org/external/datamapper/api/v1/NGDP_RPCH/WEOWORLD");
const data = await resp.json();

Truncate

Auto Table Raw

Probe History

Latency

Status Codes

Time	Status	Latency
2026-04-16 16:56:51.186467	403	156ms
2026-04-16 04:16:55.538077	403	150ms
2026-04-16 02:39:28.064294	403	142ms
2026-04-16 01:50:27.143035	403	191ms
2026-04-15 03:44:38.528789	403	203ms
2026-04-15 02:10:36.900699	403	162ms
2026-04-15 01:12:24.506572	403	163ms
2026-04-14 03:10:27.266149	403	172ms
2026-04-14 01:16:22.747223	403	157ms
2026-04-14 00:46:45.745167	403	149ms
2026-04-12 16:19:54.231622	403	296ms
2026-04-12 14:33:44.743846	403	236ms
2026-04-12 12:34:07.196346	403	161ms
2026-04-10 06:46:41.772772	403	96ms
2026-04-10 00:34:02.270766	403	104ms
2026-04-10 00:20:31.357139	403	101ms
2026-04-09 02:28:44.696199	403	130ms
2026-04-09 01:47:58.131923	403	251ms
2026-04-09 00:37:33.611225	403	204ms
2026-04-08 07:55:55.382704	403	131ms
2026-04-08 07:54:14.282185	403	150ms
2026-04-08 07:29:14.374171	403	144ms
2026-04-07 01:29:45.510098	403	156ms
2026-04-07 00:38:36.558932	403	176ms
2026-04-07 00:29:20.457672	403	176ms
2026-04-06 06:40:44.834364	403	195ms
2026-04-06 06:38:03.524890	403	198ms
2026-04-05 22:51:45.434152	403	276ms
2026-04-05 14:46:56.609305	403	834ms
2026-04-05 14:42:08.730793	403	218ms