{"openapi":"3.1.0","info":{"title":"IMF Economic Data API","version":"1.0.0","description":"Live macroeconomic data from the International Monetary Fund's World Economic Outlook — the official cross-country numbers, served from the public IMF DataMapper, no key, nothing stored. GDP, real GDP growth, inflation, gross government debt, unemployment, the current-account balance, GDP per capita and 120-plus other indicators for 200-plus countries, with the IMF's historical record back to 1980 and its forecasts several years into the future. The indicators endpoint lists every series the IMF publishes, with an optional search. The series endpoint returns one indicator's full time series for one country — every year, actual and projected. The country endpoint returns a snapshot of a country's headline numbers — real GDP growth, inflation, government debt as a share of GDP, unemployment, current-account balance and GDP per capita — across recent and forecast years. Compare economies, track the debt and growth outlook and pull the same numbers policymakers use, as live JSON. This is the IMF macro / economic-indicator cut — distinct from the FX-rate, central-bank and market-data APIs in the catalogue.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/imf-api","description":"oanor gateway"}],"tags":[{"name":"Indicators"},{"name":"Series"},{"name":"Country"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/indicators":{"get":{"operationId":"get_v1_indicators","tags":["Indicators"],"summary":"Every IMF indicator","description":"","parameters":[{"name":"search","in":"query","required":false,"description":"Filter by keyword","schema":{"type":"string"},"example":"inflation"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":2,"source":"IMF","indicators":[{"code":"PCPIPCH","unit":"Annual percent change","label":"Inflation rate, average consumer prices","source":"World Economic Outlook (April 2026)"},{"code":"PCPIEPCH","unit":"Annual percent change","label":"Inflation rate, end of period consumer prices","source":"World Economic Outlook (April 2026)"}]},"meta":{"timestamp":"2026-06-12T01:42:59.719Z","request_id":"8d7a65c7-923d-45f6-9886-f10371fd8b69"},"status":"ok","message":"Indicators retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/series":{"get":{"operationId":"get_v1_series","tags":["Series"],"summary":"One indicator time series for one country","description":"","parameters":[{"name":"indicator","in":"query","required":true,"description":"Indicator code","schema":{"type":"string"},"example":"NGDP_RPCH"},{"name":"country","in":"query","required":true,"description":"ISO-3 country code","schema":{"type":"string"},"example":"USA"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Includes IMF historical data and forecasts; later years are projections.","count":52,"source":"IMF","values":{"1980":-0.3,"1981":2.5,"1982":-1.8,"1983":4.6,"1984":7.2,"1985":4.2,"1986":3.5,"1987":3.5,"1988":4.2,"1989":3.7,"1990":1.9,"1991":-0.1,"1992":3.5,"1993":2.8,"1994":4,"1995":2.7,"1996":3.8,"1997":4.4,"1998":4.5,"1999":4.8,"2000":4.1,"2001":1,"2002":1.7,"2003":2.8,"2004":3.8,"2005":3.5,"2006":2.8,"2007":2,"2008":0.1,"2009":-2.6,"2010":2.7,"2011":1.6,"2012":2.3,"2013":2.1,"2014":2.5,"2015":2.9,"2016":1.8,"2017":2.5,"2018":3,"2019":2.6,"2020":-2.1,"2021":6.2,"2022":2.5,"2023":2.9,"2024":2.8,"2025":2.1,"2026":2.3,"2027":2.1,"2028":2.1,"2029":1.9,"2030":1.8,"2031":1.8},"country":"USA","indicator":"NGDP_RPCH","last_year":"2031","first_year":"1980","latest_value":1.8},"meta":{"timestamp":"2026-06-12T01:43:01.694Z","request_id":"575e18ed-1c7e-4140-938a-5e635090116a"},"status":"ok","message":"Series retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/country":{"get":{"operationId":"get_v1_country","tags":["Country"],"summary":"A country headline macro snapshot","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"ISO-3 country code","schema":{"type":"string"},"example":"DEU"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Germany","note":"latest values may be IMF forecasts. recent shows the last six years (actual + projected).","source":"IMF","country":"DEU","indicators":{"LUR":{"label":"Unemployment rate (%)","recent":{"2026":3.9,"2027":3.5,"2028":3.2,"2029":3,"2030":2.9,"2031":2.9},"latest_year":"2031","latest_value":2.9},"NGDPDPC":{"label":"GDP per capita (current US$)","recent":{"2026":65302.893,"2027":67613.107,"2028":69804.854,"2029":72087.756,"2030":74263.697,"2031":76425.902},"latest_year":"2031","latest_value":76425.902},"PCPIPCH":{"label":"Inflation, avg consumer prices (% change)","recent":{"2026":2.7,"2027":2.3,"2028":2,"2029":2.2,"2030":2.2,"2031":2.1},"latest_year":"2031","latest_value":2.1},"BCA_NGDPD":{"label":"Current account balance (% of GDP)","recent":{"2026":3.9,"2027":3.8,"2028":3.8,"2029":3.8,"2030":3.8,"2031":3.8},"latest_year":"2031","latest_value":3.8},"NGDP_RPCH":{"label":"Real GDP growth (%)","recent":{"2026":0.8,"2027":1.2,"2028":1.2,"2029":0.9,"2030":0.7,"2031":0.6},"latest_year":"2031","latest_value":0.6},"GGXWDG_NGDP":{"label":"Government gross debt (% of GDP)","recent":{"2026":64.6,"2027":66.5,"2028":68.4,"2029":70.2,"2030":72,"2031":73.7},"latest_year":"2031","latest_value":73.7}}},"meta":{"timestamp":"2026-06-12T01:43:04.592Z","request_id":"f06b6dd9-596e-4fd6-ad45-330577b2537d"},"status":"ok","message":"Country retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"country is an ISO-3 code (USA, DEU, CHN, IND). Find indicator codes via /v1/indicators (e.g. NGDP_RPCH = real GDP growth, PCPIPCH = inflation, GGXWDG_NGDP = govt debt % of GDP). Later years in any series are IMF projections.","source":"IMF DataMapper (imf.org/external/datamapper/api/v1, live)","service":"imf-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/series":"One indicator's full time series for one country (indicator=NGDP_RPCH&country=USA).","GET /v1/country":"A country's headline macro snapshot — growth, inflation, debt, unemployment, current account, GDP/capita (country=USA).","GET /v1/indicators":"Every IMF indicator (code, label, unit); optional search=."},"description":"Live macroeconomic data from the IMF World Economic Outlook via the public DataMapper API — GDP, growth, inflation, government debt, unemployment, current account and 120+ other indicators for 200+ countries, with history back to 1980 and forecasts several years out. The indicators endpoint lists every series; the series endpoint returns one indicator's full time series for one country (actual and forecast); the country endpoint returns a snapshot of a country's headline numbers (GDP growth, inflation, debt, unemployment, current account, GDP per capita). Live, no key, nothing stored. The IMF macro / economic-indicator cut — distinct from the FX-rate, central-bank and market-data APIs.","indicator_count":132,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T01:43:04.697Z","request_id":"41277b8e-3e84-4098-bde7-c58e45c5465b"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":20000,"rps_limit":3,"hard_limit":true},{"slug":"analyst","name":"Analyst","price_cents_month":825,"monthly_call_quota":225000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2410,"monthly_call_quota":900000,"rps_limit":28,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5560,"monthly_call_quota":3100000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/imf-api"}