IMF WEO indicator with forward forecasts API

IMF World Economic Outlook series for one country, split into observed history vs forward FORECAST years (the WEO publishes multi-year projections that the World Bank does not), with the latest actual flagged. Answers 'what is the IMF forecast for US GDP growth', 'projected inflation for a country', 'historical vs forecast government debt'.

Price$0.01per request

MethodPOST

Route/v1/gov/imf-weo-forecast

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache86400s public

govecon-dataimfweoforecastprojectiongdp-growthinflationmacro

API URLhttps://x402.hexl.dev/v1/gov/imf-weo-forecast

Integration docs

Example request

{
  "country": "USA",
  "metric": "gdp-growth"
}

Example response

{
  "country": "USA",
  "indicator": "NGDP_RPCH",
  "metric": "gdp-growth",
  "latestActual": {
    "year": 2025,
    "value": 2.1
  },
  "forecast": [
    {
      "year": 2026,
      "value": 2.3
    },
    {
      "year": 2027,
      "value": 2.1
    },
    {
      "year": 2028,
      "value": 2.1
    },
    {
      "year": 2029,
      "value": 1.9
    },
    {
      "year": 2030,
      "value": 1.8
    },
    {
      "year": 2031,
      "value": 1.8
    }
  ],
  "history": [
    {
      "year": 2021,
      "value": 6.2
    },
    {
      "year": 2022,
      "value": 2.5
    },
    {
      "year": 2023,
      "value": 2.9
    },
    {
      "year": 2024,
      "value": 2.8
    },
    {
      "year": 2025,
      "value": 2.1
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "country"
  ],
  "properties": {
    "country": {
      "type": "string",
      "description": "3-letter ISO country code (e.g. USA, JPN)."
    },
    "metric": {
      "type": "string",
      "description": "Plain name: gdp-growth, gdp-per-capita, inflation, unemployment, government-debt-pct-gdp, current-account-pct-gdp, gdp-usd."
    },
    "indicator": {
      "type": "string",
      "description": "Raw IMF WEO code (e.g. NGDP_RPCH); overrides metric."
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}