# IMF API: Get economic forecast > Gets World Economic Outlook figures for a country or region by year, labelled as actual or forecast. Measures the IMF does not publish for a year are null. Unofficial. Not affiliated with or endorsed by IMF. - Page: https://fous.com/methods/imf.org/get-economic-forecast - Method: `imf.org/get_economic_forecast`, version 1 - Website: imf.org - Returns: country code, WEO edition, and per-year GDP, growth, inflation, unemployment, debt and current account - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `country` | string | yes | `"World"` | Country or region name, such as Germany, World, or Euro area. | | `end_year` | integer | no | `2027` | Last year to show, for example 2028. Defaults to two years after the current year. | | `start_year` | integer | no | `2025` | First year to show, for example 2024. Defaults to the current year. | ## Output From a run on Oct 23, 2026. Its input: ```json { "country": "World", "end_year": 2027, "start_year": 2025 } ``` Its output: ```json { "years": [ { "year": 2025, "status": "actual", "page_url": "https://www.imf.org/external/datamapper/NGDP_RPCH@WEO/WEOWORLD", "gdp_billions_usd": 118485.328, "inflation_percent": 4.1, "gdp_per_person_usd": 14749.376, "unemployment_percent": null, "real_gdp_growth_percent": 3.5, "government_debt_percent_of_gdp": 94, "current_account_balance_percent_of_gdp": 0.5 }, { "year": 2026, "status": "forecast", "page_url": "https://www.imf.org/external/datamapper/NGDP_RPCH@WEO/WEOWORLD", "gdp_billions_usd": 128003.776, "inflation_percent": 4.7, "gdp_per_person_usd": 15889.337, "unemployment_percent": null, "real_gdp_growth_percent": 3.1, "government_debt_percent_of_gdp": 94.6, "current_account_balance_percent_of_gdp": 0.7 }, { "year": 2027, "status": "forecast", "page_url": "https://www.imf.org/external/datamapper/NGDP_RPCH@WEO/WEOWORLD", "gdp_billions_usd": 135093.196, "inflation_percent": 4.1, "gdp_per_person_usd": 16626.826, "unemployment_percent": null, "real_gdp_growth_percent": 3.4, "government_debt_percent_of_gdp": 95.8, "current_account_balance_percent_of_gdp": 0.7 } ], "country": "World", "weo_edition": "October 2026", "imf_country_code": "WEOWORLD" } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"imf.org/get_economic_forecast","input":{"country":"World","end_year":2027,"start_year":2025}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What is the projected GDP growth and inflation for Germany from 2024 to 2028? - Show me IMF forecast figures for the Euro area for 2025 through 2027, marking which years are estimates. - I need World Economic Outlook unemployment and government debt numbers for Japan between 2024 and 2026. - Can you pull the current account balance and GDP for Brazil for the years 2025 to 2029 from the IMF? - Give me the economic outlook for the World for 2024 to 2027, including inflation and debt, with actual versus forecast labels. ## Input schema ```json { "type": "object", "required": [ "country" ], "properties": { "country": { "type": "string", "description": "Country or region name, such as Germany, World, or Euro area." }, "end_year": { "type": "integer", "description": "Last year to show, for example 2028. Defaults to two years after the current year." }, "start_year": { "type": "integer", "description": "First year to show, for example 2024. Defaults to the current year." } } } ``` ## Output schema ```json { "type": "object", "required": [ "country", "imf_country_code", "weo_edition", "years" ], "properties": { "years": { "type": "array", "items": { "type": "object", "required": [ "year", "status", "real_gdp_growth_percent", "inflation_percent", "unemployment_percent", "gdp_billions_usd", "gdp_per_person_usd", "government_debt_percent_of_gdp", "current_account_balance_percent_of_gdp", "page_url" ], "properties": { "year": { "type": "integer" }, "status": { "enum": [ "actual", "forecast" ], "type": "string" }, "page_url": { "type": "string" }, "gdp_billions_usd": { "type": [ "number", "null" ] }, "inflation_percent": { "type": [ "number", "null" ] }, "gdp_per_person_usd": { "type": [ "number", "null" ] }, "unemployment_percent": { "type": [ "number", "null" ] }, "real_gdp_growth_percent": { "type": [ "number", "null" ] }, "government_debt_percent_of_gdp": { "type": [ "number", "null" ] }, "current_account_balance_percent_of_gdp": { "type": [ "number", "null" ] } } }, "description": "Economic measures for each requested year." }, "country": { "type": "string", "description": "Country or region name." }, "weo_edition": { "type": "string", "description": "World Economic Outlook edition." }, "imf_country_code": { "type": "string", "description": "IMF code for this country or group.", "x-fous-developer": true } } } ``` ## See more - [IMF API: List country rankings](https://fous.com/methods/imf.org/list-country-rankings.md): Ranks countries by a World Economic Outlook indicator for a chosen year, excluding regional and group totals and countries without a value. - [World Bank API: Get country statistic](https://fous.com/methods/data.worldbank.org/get-country-statistic.md): Looks up a World Bank statistic for a country and returns its annual values and latest value for the selected years. - [Trading Economics API: Get country economic overview](https://fous.com/methods/tradingeconomics.com/get-country-overview.md): Returns seven key economic indicators for a country from its public Trading Economics overview: GDP growth rate, inflation rate, interest rate, unemployment rate, government debt to GDP, currency and stock market. Indicators absent from the overview are null; the US dollar index is not reported as a USD exchange rate. - [FRED API: Get economic indicator](https://fous.com/methods/fred.stlouisfed.org/get-economic-indicator.md): Gets a public FRED economic series by plain name or series ID, with its observations, latest value and source details. - [World Health Organization API: Get country health statistics](https://fous.com/methods/who.int/get-country-health-statistics.md): Gets the latest WHO value of a health statistic for a country, with sex-specific values, the regional value for the same year, and up to 10 years of history. - [World Bank API: Compare countries by a statistic](https://fous.com/methods/worldbank.org/compare-countries.md): Ranks countries by a World Development Indicators statistic for a given year, or for the latest year with broad country coverage. Regional aggregates and countries without data for that year are left out. - [Trading Economics API: List countries by indicator](https://fous.com/methods/tradingeconomics.com/list-countries-by-indicator.md): Compares the latest reported value of an economic indicator across countries in a region, highest first. World includes all listed countries; Australia uses the Oceania region. - [Our World in Data API: Get statistic](https://fous.com/methods/ourworldindata.org/get-statistic.md): Finds the Our World in Data chart that best matches a statistic and returns its country-by-year numeric values, definition and source. - [All IMF methods](https://fous.com/methods/imf.org.md)