{"openapi":"3.1.0","info":{"title":"World Bank API","version":"1.0.0","description":"Economic and development data for every country, drawn from the World Bank Open Data catalogue. Pull a clean time series for any of roughly 1,500 indicators — GDP, population, inflation, life expectancy, CO₂ emissions, internet use and far more — for a chosen country and year range; list and filter countries by region or income level with capital and coordinates; look up a single country; and search the indicator catalogue to discover the codes you need. Authoritative open data returned as tidy JSON through a fast, reliable API. Ideal for fintech and research, economic dashboards and BI tools, data journalism, education and development analytics.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/worldbank-api","description":"oanor gateway"}],"tags":[{"name":"World Bank"}],"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/countries":{"get":{"operationId":"get_v1_countries","tags":["World Bank"],"summary":"List / filter countries","description":"","parameters":[{"name":"region","in":"query","required":false,"description":"Region filter","schema":{"type":"string"},"example":"Europe"},{"name":"income","in":"query","required":false,"description":"Income level filter","schema":{"type":"string"}},{"name":"search","in":"query","required":false,"description":"Name search","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"1-50","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"total":296,"returned":58,"countries":[{"id":"ALB","iso2":"AL","name":"Albania","region":"Europe & Central Asia","capital":"Tirane","latitude":41.3317,"longitude":19.8172,"income_level":"Upper middle income","lending_type":"IBRD"},{"id":"AND","iso2":"AD","name":"Andorra","region":"Europe & Central Asia","capital":"Andorra la Vella","latitude":42.5075,"longitude":1.5218,"income_level":"High income","lending_type":"Not classified"},{"id":"ARM","iso2":"AM","name":"Armenia","region":"Europe & Central Asia","capital":"Yerevan","latitude":40.1596,"longitude":44.509,"income_level":"Upper middle income","lending_type":"IBRD"},{"id":"AUT","iso2":"AT","name":"Austria","region":"Europe & Central Asia","capital":"Vienna","latitude":48.2201,"longitude":16.3798,"income_level":"High income","lending_type":"Not classified"},{"id":"AZE","iso2":"AZ","name":"Azerbaijan","region":"Europe & Central Asia","capital":"Baku","latitude":40.3834,"longitude":49.8932,"income_level":"Upper middle income","lending_type":"IBRD"},{"id":"BEL","iso2":"BE","name":"Belgium","region":"Europe & Central Asia","capital":"Brussels","latitude":50.8371,"longitude":4.36761,"income_level":"High income","lending_type":"Not classified"},{"id":"BGR","iso2":"BG","name":"Bulgaria","region":"Europe & Central Asia","capital":"Sofia","latitude":42.7105,"longitude":23.3238,"income_level":"High income","lending_type":"IBRD"},{"id":"BIH","iso2":"BA","name":"Bosnia and Herzegovina","region":"Europe & Central Asia","capital":"Sarajevo","latitude":43.8607,"longitude":18.4214,"income_level":"Upper middle income","lending_type":"IBRD"},{"id":"BLR","iso2":"BY","name":"Belarus","region":"Europe & Central Asia","capital":"Minsk","latitude":53.9678,"longitude":27.5766,"income_level":"Upper middle income","lending_type":"IBRD"},{"id":"CHE","iso2":"CH","name":"Switzerland","region":"Europe & Central Asia","capital":"Bern","latitude":46.948,"longitude":7.44821,"income_level":"High income","lending_type":"Not classified"},{"id":"CHI","iso2":"JG","name":"Channel Islands","region":"Europe & Central Asia","income_level":"High income","lending_type":"Not classified"},{"id":"CYP","iso2":"CY","name":"Cyprus","region":"Europe & Central Asia","capital":"Nicosia","latitude":35.1676,"longitude":33.3736,"income_level":"High income","lending_type":"Not classified"},{"id":"CZE","iso2":"CZ","name":"Czechia","region":"Europe & Central Asia","capital":"Prague","latitude":50.0878,"longitude":14.4205,"income_level":"High income","lending_type":"Not classified"},{"id":"DEU","iso2":"DE","name":"Germany","region":"Europe & Central Asia","capital":"Berlin","latitude":52.5235,"longitude":13.4115,"income_level":"High income","lending_type":"Not classified"},{"id":"DNK","iso2":"DK","name":"Denmark","region":"Europe & Central Asia","capital":"Copenhagen","latitude":55.6763,"longitude":12.5681,"income_level":"High income","lending_type":"Not classified"},{"id":"ESP","iso2":"ES","name":"Spain","region":"Europe & Central Asia","capital":"Madrid","latitude":40.4167,"longitude":-3.70327,"income_level":"High income","lending_type":"Not classified"},{"id":"EST","iso2":"EE","name":"Estonia","region":"Europe & Central Asia","capital":"Tallinn","latitude":59.4392,"longitude":24.7586,"income_level":"High income","lending_type":"Not classified"},{"id":"FIN","iso2":"FI","name":"Finland","region":"Europe & Central Asia","capital":"Helsinki","latitude":60.1608,"longitude":24.9525,"income_level":"High income","lending_type":"Not classified"},{"id":"FRA","iso2":"FR","name":"France","region":"Europe & Central Asia","capital":"Paris","latitude":48.8566,"longitude":2.35097,"income_level":"High income","lending_type":"Not classified"},{"id":"FRO","iso2":"FO","name":"Faroe Islands","region":"Europe & Central Asia","capital":"Torshavn","latitude":61.8926,"longitude":-6.91181,"income_level":"High income","lending_type":"Not classified"},{"id":"GBR","iso2":"GB","name":"United Kingdom","region":"Europe & Central Asia","capital":"London","latitude":51.5002,"longitude":-0.126236,"income_level":"High income","lending_type":"Not classified"},{"id":"GEO","iso2":"GE","name":"Georgia","region":"Europe & Central Asia","capital":"Tbilisi","latitude":41.71,"longitude":44.793,"income_level":"Upper middle income","lending_type":"IBRD"},{"id":"GIB","iso2":"GI","name":"Gibraltar","region":"Europe & Central Asia","income_level":"High income","lending_type":"Not classified"},{"id":"GRC","iso2":"GR","name":"Greece","region":"Europe & Central Asia","capital":"Athens","latitude":37.9792,"longitude":23.7166,"income_level":"High income","lending_type":"Not classified"},{"id":"GRL","iso2":"GL","name":"Greenland","region":"Europe & Central Asia","capital":"Nuuk","latitude":64.1836,"longitude":-51.7214,"income_level":"High income","lending_type":"Not classified"},{"id":"HRV","iso2":"HR","name":"Croatia","region":"Europe & Central Asia","capital":"Zagreb","latitude":45.8069,"longitude":15.9614,"income_level":"High income","lending_type":"IBRD"},{"id":"HUN","iso2":"HU","name":"Hungary","region":"Europe & Central Asia","capital":"Budapest","latitude":47.4984,"longitude":19.0408,"income_level":"High income","lending_type":"Not classified"},{"id":"IMN","iso2":"IM","name":"Isle of Man","region":"Europe & Central Asia","capital":"Douglas","latitude":54.1509,"longitude":-4.47928,"income_level":"High income","lending_type":"Not classified"},{"id":"IRL","iso2":"IE","name":"Ireland","region":"Europe & Central Asia","capital":"Dublin","latitude":53.3441,"longitude":-6.26749,"income_level":"High income","lending_type":"Not classified"},{"id":"ISL","iso2":"IS","name":"Iceland","region":"Europe & Central Asia","capital":"Reykjavik","latitude":64.1353,"longitude":-21.8952,"income_level":"High income","lending_type":"Not classified"},{"id":"ITA","iso2":"IT","name":"Italy","region":"Europe & Central Asia","capital":"Rome","latitude":41.8955,"longitude":12.4823,"income_level":"High income","lending_type":"Not classified"},{"id":"KAZ","iso2":"KZ","name":"Kazakhstan","region":"Europe & Central Asia","capital":"Astana","latitude":51.1879,"longitude":71.4382,"income_level":"Upper middle income","lending_type":"IBRD"},{"id":"KGZ","iso2":"KG","name":"Kyrgyz Republic","region":"Europe & Central Asia","capital":"Bishkek","latitude":42.8851,"longitude":74.6057,"income_level":"Lower middle income","lending_type":"IDA"},{"id":"LIE","iso2":"LI","name":"Liechtenstein","region":"Europe & Central Asia","capital":"Vaduz","latitude":47.1411,"longitude":9.52148,"income_level":"High income","lending_type":"Not classified"},{"id":"LTU","iso2":"LT","name":"Lithuania","region":"Europe & Central Asia","capital":"Vilnius","latitude":54.6896,"longitude":25.2799,"income_level":"High income","lending_type":"Not classified"},{"id":"LUX","iso2":"LU","name":"Luxembourg","region":"Europe & Central Asia","capital":"Luxembourg","latitude":49.61,"longitude":6.1296,"income_level":"High income","lending_type":"Not classified"},{"id":"LVA","iso2":"LV","name":"Latvia","region":"Europe & Central Asia","capital":"Riga","latitude":56.9465,"longitude":24.1048,"income_level":"High income","lending_type":"Not classified"},{"id":"MCO","iso2":"MC","name":"Monaco","region":"Europe & Central Asia","capital":"Monaco","latitude":43.7325,"longitude":7.41891,"income_level":"High income","lending_type":"Not classified"},{"id":"MDA","iso2":"MD","name":"Moldova","region":"Europe & Central Asia","capital":"Chisinau","latitude":47.0167,"longitude":28.8497,"income_level":"Upper middle income","lending_type":"IBRD"},{"id":"MKD","iso2":"MK","name":"North Macedonia","region":"Europe & Central Asia","capital":"Skopje","latitude":42.0024,"longitude":21.4361,"income_level":"Upper middle income","lending_type":"IBRD"},{"id":"MNE","iso2":"ME","name":"Montenegro","region":"Europe & Central Asia","capital":"Podgorica","latitude":42.4602,"longitude":19.2595,"income_level":"Upper middle income","lending_type":"IBRD"},{"id":"NLD","iso2":"NL","name":"Netherlands","region":"Europe & Central Asia","capital":"Amsterdam","latitude":52.3738,"longitude":4.89095,"income_level":"High income","lending_type":"Not classified"},{"id":"NOR","iso2":"NO","name":"Norway","region":"Europe & Central Asia","capital":"Oslo","latitude":59.9138,"longitude":10.7387,"income_level":"High income","lending_type":"Not classified"},{"id":"POL","iso2":"PL","name":"Poland","region":"Europe & Central Asia","capital":"Warsaw","latitude":52.26,"longitude":21.02,"income_level":"High income","lending_type":"IBRD"},{"id":"PRT","iso2":"PT","name":"Portugal","region":"Europe & Central Asia","capital":"Lisbon","latitude":38.7072,"longitude":-9.13552,"income_level":"High income","lending_type":"Not classified"},{"id":"ROU","iso2":"RO","name":"Romania","region":"Europe & Central Asia","capital":"Bucharest","latitude":44.4479,"longitude":26.0979,"income_level":"High income","lending_type":"IBRD"},{"id":"RUS","iso2":"RU","name":"Russian Federation","region":"Europe & Central Asia","capital":"Moscow","latitude":55.7558,"longitude":37.6176,"income_level":"High income","lending_type":"IBRD"},{"id":"SMR","iso2":"SM","name":"San Marino","region":"Europe & Central Asia","capital":"San Marino","latitude":43.9322,"longitude":12.4486,"income_level":"High income","lending_type":"Not classified"},{"id":"SRB","iso2":"RS","name":"Serbia","region":"Europe & Central Asia","capital":"Belgrade","latitude":44.8024,"longitude":20.4656,"income_level":"Upper middle income","lending_type":"IBRD"},{"id":"SVK","iso2":"SK","name":"Slovak Republic","region":"Europe & Central Asia","capital":"Bratislava","latitude":48.1484,"longitude":17.1073,"income_level":"High income","lending_type":"Not classified"},{"id":"SVN","iso2":"SI","name":"Slovenia","region":"Europe & Central Asia","capital":"Ljubljana","latitude":46.0546,"longitude":14.5044,"income_level":"High income","lending_type":"Not classified"},{"id":"SWE","iso2":"SE","name":"Sweden","region":"Europe & Central Asia","capital":"Stockholm","latitude":59.3327,"longitude":18.0645,"income_level":"High income","lending_type":"Not classified"},{"id":"TJK","iso2":"TJ","name":"Tajikistan","region":"Europe & Central Asia","capital":"Dushanbe","latitude":38.5878,"longitude":68.7864,"income_level":"Lower middle income","lending_type":"IDA"},{"id":"TKM","iso2":"TM","name":"Turkmenistan","region":"Europe & Central Asia","capital":"Ashgabat","latitude":37.9509,"longitude":58.3794,"income_level":"Upper middle income","lending_type":"IBRD"},{"id":"TUR","iso2":"TR","name":"Turkiye","region":"Europe & Central Asia","capital":"Ankara","latitude":39.7153,"longitude":32.3606,"income_level":"Upper middle income","lending_type":"IBRD"},{"id":"UKR","iso2":"UA","name":"Ukraine","region":"Europe & Central Asia","capital":"Kiev","latitude":50.4536,"longitude":30.5038,"income_level":"Upper middle income","lending_type":"IBRD"},{"id":"UZB","iso2":"UZ","name":"Uzbekistan","region":"Europe & Central Asia","capital":"Tashkent","latitude":41.3052,"longitude":69.269,"income_level":"Lower middle income","lending_type":"Blend"},{"id":"XKX","iso2":"XK","name":"Kosovo","region":"Europe & Central Asia","capital":"Pristina","latitude":42.565,"longitude":20.926,"income_level":"Upper middle income","lending_type":"IDA"}]},"meta":{"timestamp":"2026-05-30T18:16:59.435Z","request_id":"c6bce789-20da-4545-b6a0-041176b48e8e"},"status":"ok","message":"Countries retrieved","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":["World Bank"],"summary":"Single country","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"2- or 3-letter country code","schema":{"type":"string"},"example":"DE"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"DEU","iso2":"DE","name":"Germany","region":"Europe & Central Asia","capital":"Berlin","latitude":52.5235,"longitude":13.4115,"income_level":"High income","lending_type":"Not classified"},"meta":{"timestamp":"2026-05-30T18:16:59.883Z","request_id":"f79d4a09-7603-4076-8752-32271cb9dd4d"},"status":"ok","message":"Country retrieved","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/indicator":{"get":{"operationId":"get_v1_indicator","tags":["World Bank"],"summary":"Indicator time series","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"2- or 3-letter country code","schema":{"type":"string"},"example":"US"},{"name":"indicator","in":"query","required":true,"description":"World Bank indicator code","schema":{"type":"string"},"example":"NY.GDP.MKTP.CD"},{"name":"start","in":"query","required":false,"description":"Start year","schema":{"type":"string"},"example":"2018"},{"name":"end","in":"query","required":false,"description":"End year","schema":{"type":"string"},"example":"2022"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":5,"series":[{"date":"2022","value":25604848907611},{"date":"2021","value":23315080560000},{"date":"2020","value":21060473613000},{"date":"2019","value":21380976119000},{"date":"2018","value":20533057312000}],"country":{"id":"USA","name":"United States"},"indicator":{"id":"NY.GDP.MKTP.CD","name":"GDP (current US$)"},"last_updated":"2026-04-08"},"meta":{"timestamp":"2026-05-30T18:17:00.394Z","request_id":"2667764d-97d7-4851-9159-d0a4ffc5cf69"},"status":"ok","message":"Indicator series retrieved","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/indicators":{"get":{"operationId":"get_v1_indicators","tags":["World Bank"],"summary":"Search indicator catalogue","description":"","parameters":[{"name":"search","in":"query","required":false,"description":"Search by name or code","schema":{"type":"string"},"example":"GDP"},{"name":"page","in":"query","required":false,"description":"1-50","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"page":1,"pages":8,"total":1486,"returned":7,"indicators":[{"id":"BG.GSR.NFSV.GD.ZS","name":"Trade in services (% of GDP)","source":"World Development Indicators","topics":["Economy & Growth","Private Sector","Trade"]},{"id":"BM.KLT.DINV.WD.GD.ZS","name":"Foreign direct investment, net outflows (% of GDP)","source":"World Development Indicators","topics":["Economy & Growth","Financial Sector "]},{"id":"BN.CAB.XOKA.GD.ZS","name":"Current account balance (% of GDP)","source":"World Development Indicators","topics":["Economy & Growth"]},{"id":"BX.KLT.DINV.WD.GD.ZS","name":"Foreign direct investment, net inflows (% of GDP)","source":"World Development Indicators","topics":["Economy & Growth","Financial Sector ","Climate Change"]},{"id":"BX.TRF.PWKR.DT.GD.ZS","name":"Personal remittances, received (% of GDP)","source":"World Development Indicators","topics":["Economy & Growth","Financial Sector "]},{"id":"CM.MKT.LCAP.GD.ZS","name":"Market capitalization of listed domestic companies (% of GDP)","source":"World Development Indicators","topics":["Financial Sector "]},{"id":"CM.MKT.TRAD.GD.ZS","name":"Stocks traded, total value (% of GDP)","source":"World Development Indicators","topics":["Financial Sector "]}]},"meta":{"timestamp":"2026-05-30T18:17:00.903Z","request_id":"f505f618-22bc-4c0f-8a03-db3fe3359cfb"},"status":"ok","message":"Indicators retrieved","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":1500,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":600,"monthly_call_quota":40000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1700,"monthly_call_quota":250000,"rps_limit":12,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4200,"monthly_call_quota":1500000,"rps_limit":30,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/worldbank-api"}