Global Economy & Trade

IMF SDMX 3.0 generic time series

Fetch an IMF SDMX 3.0 time series via the public API (no key).

Source: International Monetary Fund. See /imf/dataflows for families and /imf/dataflows/{dataflow} for the valid indicator codes.

get/api/v1/imf/series/{dataflow}/{country}

Path parameters

dataflowstring required

Family slug: bop, irfcl, fsi, gfs, pcps, or cpi.

countrystring required

Reporter: ISO3 code, snake_case name, region alias, or 'all'. PCPS commodity prices are global - use 'world' or 'all' with a pinned indicator.

Query parameters

indicatorstring nullable

Indicator code from /imf/dataflows/{dataflow} (for CPI this is the COICOP expenditure code). Omit to fetch all indicators (bounded to the latest N). Required when country is 'all'.

Example:CP01

Indicator code from /imf/dataflows/{dataflow} (for CPI this is the COICOP expenditure code). Omit to fetch all indicators (bounded to the latest N). Required when country is 'all'.

frequencystring nullable

month, quarter, annual, or an SDMX code (A/Q/M).

start_datestring nullable

Inclusive lower bound (YYYY-MM-DD).

end_datestring nullable

Inclusive upper bound (YYYY-MM-DD).

limitinteger nullable

Most-recent N observations per series.

filtersstring nullable

Pin extra dimensions, comma-separated DIMENSION:CODE. Use a dimension the chosen dataflow has (see /imf/dataflows/{dataflow}): e.g. TYPE_OF_TRANSFORMATION:IX for cpi, SECTOR:S1311 for gfs, BOP_ACCOUNTING_ENTRY:B_CA for bop.

Example:TYPE_OF_TRANSFORMATION:IX

Response

Time series for one IMF SDMX dataflow family, country, and indicator.

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "data_age_days": 8.532,
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes

Changed in 3 of the 22 revisions of this API.18

Sep 1, 2026328d061c12ca3See the full diff
- ○
  added the optional property meta/data_age_days to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/notes to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/period to the response with the 200 status
  response-optional-property-added
Aug 24, 202664715a22734d3See the full diff
- ○
  added the optional property data/count to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/dataflow to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/results to the response with the 200 status
  response-optional-property-added
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 8, 20264c4530760ba112See the full diff
- ○
  added the optional property code to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 503 status
  response-optional-property-added

Full history