World Bank Open Data
App · Research & Academia · 16 actions
Read the World Bank's open development data with no account or API key: GDP, population, inflation, life expectancy, poverty and more than 28,000 other indicators for over 200 economies and their regional and income groups, from the World Development Indicators and the World Bank's other databases, plus poverty and inequality estimates from its Poverty and Inequality Platform. Get a country's latest figure or its history, compare or rank countries, build a country profile and search the indicator catalogue.
Actions
| Action | What it does |
|---|---|
| Compare countries | Put two to fifty countries side by side on one indicator and rank them, in a single step. |
| Find indicators | Look indicators up by name, code or definition, such as gdp per capita or school enrollment, to find the code the other actions take. |
| Get a country | Get one country's or group's World Bank details, found by name or code: its ISO codes, region, income group, lending type and capital. |
| Get a country profile | Get several headline figures for one country at once: population, GDP, GDP per capita, growth, inflation, unemployment, life expectancy and poverty unless you choose others. |
| Get a country's latest value | Get the most recent value of one indicator for one country, with the value before it and how much it changed, returned flat so a later step can read the number without indexing into a list. |
| Get a country's values over time | Get one indicator for one country year by year, oldest first, with the first and last values, the change between them, the average growth per year and the highest and lowest points. |
| Get an indicator's definition | Get what an indicator measures: its full definition, the database it belongs to, the organizations that collect it and the topics it is filed under. |
| Get indicator data | Get the values of one indicator for some countries, or all of them, over a range of years: one row per country and period, newest first. |
| Get poverty by region | Get the share and number of people below a poverty line in each World Bank region and in the world as a whole, from the Poverty and Inequality Platform. |
| Get poverty estimates | Get the share and number of people living below a poverty line in one country, with inequality and average income, from the World Bank's Poverty and Inequality Platform. |
| List a topic's indicators | List the indicators filed under one topic, such as Education or Climate Change, by name. |
| List countries | List the 217 economies the World Bank reports on, with each one's codes, region, income group, lending type and capital. |
| List databases | List the World Bank's databases, from the World Development Indicators to education, gender and debt statistics, with when each was last updated. |
| List regions and groups | List the World Bank's seven geographic regions and the other country groups it reports on, such as the European Union and small states, with their codes. |
| List topics | List the 21 subjects the World Bank files its indicators under, such as Health, Education and Poverty, with what each covers. |
| Rank countries | The highest or lowest countries in the world on one indicator, with the world figure alongside. |
Compare countries
Put two to fifty countries side by side on one indicator and rank them, in a single step. Leaving the year empty gives each country its own most recent value, which can be a different year for each; every row carries its own period, and countries with no value are listed as missing.
Inputs
- Indicator
indicatortextRequired - What to measure. Pick a World Development Indicator from the list, or type any World Bank indicator code such as NY.GDP.MKTP.CD, including one found with 'Find indicators'.
- Countries
countrieslistRequired - Which countries to compare, two to fifty. A value from an earlier step can be a list of names or codes, or one comma-separated line.
- Year
yearnumber - Use each country's value for this year. Leave empty to use each country's most recent value, which can be a different year for each.From 1800 to 2100.
- Order
ordertext - Highest first by default. Lowest first suits an indicator where small is good, such as infant mortality.One of:
highest_first(Highest first),lowest_first(Lowest first). Default:highest_first. - Database
sourcetext - Which World Bank database to read. Leave empty for the World Development Indicators, or the indicator's own database when it is not one of them.
Outputs
as_oftext- The year compared, or latest available.
countnumber- How many countries had a value.
countrieslist- The countries in rank order.
indicatortext- The indicator's name.
indicator_codetext- The indicator's code.
last_updatedtext- When that database was last updated (YYYY-MM-DD).
leadertext- The country ranked first.
leader_valuenumber- Its value.
missinglist- The countries with no value to compare.
ordertext- highest_first or lowest_first.
sourcetext- The name of that database.
source_idtext- The id of the database the figures came from.
Example output
{
"as_of": "latest available",
"count": 3,
"countries": [
{
"country": "United States",
"country_code": "USA",
"period": "2025",
"rank": 1,
"value": 90026.5163005744,
"year": 2025
},
{
"country": "China",
"country_code": "CHN",
"period": "2025",
"rank": 2,
"value": 13861.970224368,
"year": 2025
},
{
"country": "India",
"country_code": "IND",
"period": "2025",
"rank": 3,
"value": 2702.47987141553,
"year": 2025
}
],
"indicator": "GDP per capita (current US$)",
"indicator_code": "NY.GDP.PCAP.CD",
"last_updated": "2026-07-13",
"leader": "United States",
"leader_value": 90026.5163005744,
"missing": [],
"order": "highest_first",
"source": "World Development Indicators",
"source_id": "2"
}Find indicators
Look indicators up by name, code or definition, such as gdp per capita or school enrollment, to find the code the other actions take. Searches the World Development Indicators unless you pick another database or every database; the best matches come first.
Inputs
- Search for
querytextRequired - A few words, or an indicator code.
- Database
sourcetext - Where to search. Leave empty for the World Development Indicators. Every database covers some 28,500 indicators and takes a few seconds; it leaves out the WDI Database Archives, whose data can no longer be read, unless you pick them on their own.
- How many
limitnumber - The most matches to return. Defaults to 20.From 1 to 100. Default:
20.
Outputs
countnumber- How many are returned.
indicatorslist- The best matches first.
querytext- The words searched for.
source_idtext- The database searched, or null for every database.
total_matchesnumber- How many indicators matched in all.
Example output
{
"count": 1,
"indicators": [
{
"code": "NY.GDP.PCAP.CD",
"description": "Gross domestic product is the total income earned through the production of goods and services in an economic territory during an accounting period.",
"name": "GDP per capita (current US$)",
"source": "World Development Indicators",
"source_id": "2",
"topics": [
"Economy & Growth"
],
"url": "https://data.worldbank.org/indicator/NY.GDP.PCAP.CD"
}
],
"query": "gdp per capita",
"source_id": "2",
"total_matches": 25
}Get a country
Get one country's or group's World Bank details, found by name or code: its ISO codes, region, income group, lending type and capital.
Inputs
- Country
countrytextRequired - Pick a country or group from the list, or type a name or an ISO code such as Kenya, KEN or KE.
Outputs
capital_citytext- Its capital city.
codetext- The ISO 3 code, such as KEN.
income_leveltext- Its World Bank income group.
income_level_codetext- The income group's code.
is_aggregatetrue/false- True for a group of countries, such as World.
iso2_codetext- The ISO 2 code, such as KE.
latitudenumber- The capital's latitude.
lending_typetext- How it borrows from the World Bank: IBRD, IDA or Blend.
lending_type_codetext- The lending type's code.
longitudenumber- The capital's longitude.
nametext- The World Bank's name for it.
regiontext- Its region, or null for a group of countries.
region_codetext- The region's code.
urltext- Its page on data.worldbank.org.
Example output
{
"capital_city": "Nairobi",
"code": "KEN",
"income_level": "Lower middle income",
"income_level_code": "LMC",
"is_aggregate": false,
"iso2_code": "KE",
"latitude": -1.27975,
"lending_type": "Blend",
"lending_type_code": "IDB",
"longitude": 36.8126,
"name": "Kenya",
"region": "Sub-Saharan Africa",
"region_code": "SSF",
"url": "https://data.worldbank.org/country/ke"
}Get a country profile
Get several headline figures for one country at once: population, GDP, GDP per capita, growth, inflation, unemployment, life expectancy and poverty unless you choose others. One step instead of eight, each figure with its own year; one the country does not report is marked not found rather than left out.
Inputs
- Country
countrytextRequired - Pick a country or group from the list, or type a name or an ISO code such as Kenya, KEN or KE.
- Figures
indicatorslist - Which World Development Indicators to include, up to twenty. Eight headline ones by default.One or more of:
SP.POP.TOTL(Population, total),NY.GDP.MKTP.CD(GDP (current US$)),NY.GDP.PCAP.CD(GDP per capita (current US$)),NY.GDP.MKTP.KD.ZG(GDP growth (annual %)),FP.CPI.TOTL.ZG(Inflation, consumer prices (annual %)),SL.UEM.TOTL.ZS(Unemployment (% of labor force)),SP.DYN.LE00.IN(Life expectancy at birth (years)),SI.POV.DDAY(Poverty at $3.00 a day (% of population)),NY.GNP.PCAP.CD(GNI per capita, Atlas method (current US$)),NY.GDP.PCAP.PP.CD(GDP per capita, PPP (current international $)), and 17 more. Default:["SP.POP.TOTL", "NY.GDP.MKTP.CD", "NY.GDP.PCAP.CD", "NY.GDP.MKTP.KD.ZG", "FP.CPI.TOTL.ZG", "SL.UEM.TOTL.ZS", "SP.DYN.LE00.IN", "SI.POV.DDAY"]. - Year
yearnumber - Use the values for this year. Leave empty for each figure's most recent value.From 1800 to 2100.
Outputs
as_oftext- The year used, or latest available.
countnumber- How many figures were asked for.
countrytext- The country.
country_codetext- Its ISO 3 code.
found_countnumber- How many of them the country has.
indicatorslist- One entry per indicator, in the order asked for.
last_updatedtext- When that database was last updated (YYYY-MM-DD).
sourcetext- The name of that database.
source_idtext- The database the figures came from.
Example output
{
"as_of": "latest available",
"count": 3,
"country": "Kenya",
"country_code": "KEN",
"found_count": 3,
"indicators": [
{
"formatted": "57.53 million",
"found": true,
"indicator": "Population, total",
"indicator_code": "SP.POP.TOTL",
"period": "2025",
"value": 57532493,
"year": 2025
},
{
"formatted": "US$ 2,363",
"found": true,
"indicator": "GDP per capita (current US$)",
"indicator_code": "NY.GDP.PCAP.CD",
"period": "2025",
"value": 2362.86091198611,
"year": 2025
},
{
"formatted": "63.83",
"found": true,
"indicator": "Life expectancy at birth, total (years)",
"indicator_code": "SP.DYN.LE00.IN",
"period": "2024",
"value": 63.834,
"year": 2024
}
],
"last_updated": "2026-07-13",
"source": "World Development Indicators",
"source_id": "2"
}Get a country's latest value
Get the most recent value of one indicator for one country, with the value before it and how much it changed, returned flat so a later step can read the number without indexing into a list. Answers questions like what is GDP in Kenya in one step. No account or API key required.
Inputs
- Indicator
indicatortextRequired - What to measure. Pick a World Development Indicator from the list, or type any World Bank indicator code such as NY.GDP.MKTP.CD, including one found with 'Find indicators'.
- Country
countrytextRequired - Pick a country or group from the list, or type a name or an ISO code such as Kenya, KEN or KE.
- Database
sourcetext - Which World Bank database to read. Leave empty for the World Development Indicators, or the indicator's own database when it is not one of them.
Outputs
changenumber- The newest value minus the one before.
countrytext- The country.
country_codetext- Its ISO 3 code.
formattedtext- The value written out, such as US$ 30.77 trillion.
foundtrue/false- False when the country has no value at all.
indicatortext- The indicator's name.
indicator_codetext- The indicator's code.
last_updatedtext- When that database was last updated (YYYY-MM-DD).
percent_changenumber- That change as a percentage of the one before.
periodtext- The period of the newest value.
previous_periodtext- The period of the value before it.
previous_valuenumber- The value before it.
sourcetext- The name of that database.
source_idtext- The id of the database the figures came from.
urltext- The indicator's page on data.worldbank.org.
valuenumber- The newest value.
yearnumber- That period's year.
Example output
{
"change": 1471687000000.0,
"country": "United States",
"country_code": "USA",
"formatted": "US$ 30.77 trillion",
"found": true,
"indicator": "GDP (current US$)",
"indicator_code": "NY.GDP.MKTP.CD",
"last_updated": "2026-07-13",
"percent_change": 5.02,
"period": "2025",
"previous_period": "2024",
"previous_value": 29298013000000,
"source": "World Development Indicators",
"source_id": "2",
"url": "https://data.worldbank.org/indicator/NY.GDP.MKTP.CD",
"value": 30769700000000,
"year": 2025
}Get a country's values over time
Get one indicator for one country year by year, oldest first, with the first and last values, the change between them, the average growth per year and the highest and lowest points. Years with no value are left out.
Inputs
- Indicator
indicatortextRequired - What to measure. Pick a World Development Indicator from the list, or type any World Bank indicator code such as NY.GDP.MKTP.CD, including one found with 'Find indicators'.
- Country
countrytextRequired - Pick a country or group from the list, or type a name or an ISO code such as Kenya, KEN or KE.
- From year
start_yearnumber - The first year to include. Leave empty to start at 1960.From 1800 to 2100.
- To year
end_yearnumber - The last year to include. Leave empty for the latest available.From 1800 to 2100.
- Database
sourcetext - Which World Bank database to read. Leave empty for the World Development Indicators, or the indicator's own database when it is not one of them.
Outputs
averagenumber- The mean value.
average_annual_growthnumber- The compound growth per year, in percent.
changenumber- The last value minus the first.
countnumber- How many values there are.
countrytext- The country.
country_codetext- Its ISO 3 code.
first_periodtext- The earliest period with a value.
first_valuenumber- Its value.
indicatortext- The indicator's name.
indicator_codetext- The indicator's code.
last_periodtext- The latest period with a value.
last_updatedtext- When that database was last updated (YYYY-MM-DD).
last_valuenumber- Its value.
maximumnumber- The highest value.
maximum_periodtext- When it was highest.
minimumnumber- The lowest value.
minimum_periodtext- When it was lowest.
percent_changenumber- That change as a percentage of the first value.
pointslist- Every value, oldest first.
sourcetext- The name of that database.
source_idtext- The id of the database the figures came from.
Example output
{
"average": 63.6763,
"average_annual_growth": 0.22,
"change": 0.285,
"count": 3,
"country": "Kenya",
"country_code": "KEN",
"first_period": "2022",
"first_value": 63.549,
"indicator": "Life expectancy at birth, total (years)",
"indicator_code": "SP.DYN.LE00.IN",
"last_period": "2024",
"last_updated": "2026-07-13",
"last_value": 63.834,
"maximum": 63.834,
"maximum_period": "2024",
"minimum": 63.549,
"minimum_period": "2022",
"percent_change": 0.45,
"points": [
{
"period": "2022",
"value": 63.549,
"year": 2022
},
{
"period": "2023",
"value": 63.646,
"year": 2023
},
{
"period": "2024",
"value": 63.834,
"year": 2024
}
],
"source": "World Development Indicators",
"source_id": "2"
}Get an indicator's definition
Get what an indicator measures: its full definition, the database it belongs to, the organizations that collect it and the topics it is filed under.
Inputs
- Indicator
indicatortextRequired - What to measure. Pick a World Development Indicator from the list, or type any World Bank indicator code such as NY.GDP.MKTP.CD, including one found with 'Find indicators'.
Outputs
archivedtrue/false- True when the indicator is in the WDI Database Archives, whose figures this API no longer serves.
codetext- The indicator's code.
descriptiontext- The indicator's full definition.
nametext- The indicator's name.
organizationtext- The organizations that collect the figures.
sourcetext- The name of that database.
source_idtext- The id of the database it belongs to.
topicslist- The topics the indicator is filed under.
urltext- Its page on data.worldbank.org, for WDI indicators.
Example output
{
"archived": false,
"code": "NY.GDP.PCAP.CD",
"description": "Gross domestic product is the total income earned through the production of goods and services in an economic territory during an accounting period.",
"name": "GDP per capita (current US$)",
"organization": "Country official statistics, National Statistical Organizations and/or Central Banks",
"source": "World Development Indicators",
"source_id": "2",
"topics": [
{
"id": "3",
"name": "Economy & Growth"
}
],
"url": "https://data.worldbank.org/indicator/NY.GDP.PCAP.CD"
}Get indicator data
Get the values of one indicator for some countries, or all of them, over a range of years: one row per country and period, newest first. Quarterly and monthly figures can be asked for where a database publishes them. Up to 20,000 rows.
Inputs
- Indicator
indicatortextRequired - What to measure. Pick a World Development Indicator from the list, or type any World Bank indicator code such as NY.GDP.MKTP.CD, including one found with 'Find indicators'.
- Countries
countrieslist - Which countries or groups to include. Leave empty for every country and group. A value from an earlier step can be a list of names or codes, or one comma-separated line.
- From year
start_yearnumber - The first year to include. Leave empty to start at 1960.From 1800 to 2100.
- To year
end_yearnumber - The last year to include. Leave empty for the latest available.From 1800 to 2100.
- Frequency
frequencytext - Annual by default. Quarterly and monthly values exist only in some databases, such as the Global Economic Monitor.One of:
annual,quarterly,monthly. Default:annual. - Database
sourcetext - Which World Bank database to read. Leave empty for the World Development Indicators, or the indicator's own database when it is not one of them.
- Leave out empty years
skip_emptytrue/false - On by default: years with no reported value are left out. Off, they are included with a null value.Default:
true. - Maximum rows
limitnumber - The most rows to return. Defaults to 1,000.From 1 to 20000. Default:
1000.
Outputs
countnumber- How many are returned.
frequencytext- annual, quarterly or monthly.
indicatortext- The indicator's name.
indicator_codetext- The indicator's code.
last_updatedtext- When that database was last updated (YYYY-MM-DD).
rowslist- Country by country, newest period first.
sourcetext- The name of that database.
source_idtext- The id of the database the figures came from.
total_rowsnumber- How many values matched in all.
truncatedtrue/false- True when more matched than the limit allowed.
urltext- The indicator's page on data.worldbank.org.
Example output
{
"count": 4,
"frequency": "annual",
"indicator": "Population, total",
"indicator_code": "SP.POP.TOTL",
"last_updated": "2026-07-13",
"rows": [
{
"country": "Brazil",
"country_code": "BRA",
"period": "2024",
"value": 211998573,
"year": 2024
},
{
"country": "Brazil",
"country_code": "BRA",
"period": "2023",
"value": 211140729,
"year": 2023
},
{
"country": "India",
"country_code": "IND",
"period": "2024",
"value": 1450935791,
"year": 2024
},
{
"country": "India",
"country_code": "IND",
"period": "2023",
"value": 1438069596,
"year": 2023
}
],
"source": "World Development Indicators",
"source_id": "2",
"total_rows": 4,
"truncated": false,
"url": "https://data.worldbank.org/indicator/SP.POP.TOTL"
}Get poverty by region
Get the share and number of people below a poverty line in each World Bank region and in the world as a whole, from the Poverty and Inequality Platform.
Inputs
- Year
yeartext - A year such as 2019, or leave empty for the latest year the World Bank has estimated.
- Poverty line (US$ a day)
poverty_linenumber - The daily income or consumption, in 2021 US dollars adjusted for prices, that counts as poor. Defaults to 3.00, the international extreme poverty line; 4.20 and 8.30 are the lines for lower and upper middle income countries.From 0.01 to 1000.0. Default:
3.0.
Outputs
countnumber- How many regions are listed.
poverty_linenumber- The poverty line, in US$ a day.
regionslist- The regions, poorest first.
worldobject- The world as a whole.
yearnumber- The year.
Example output
{
"count": 2,
"poverty_line": 3.0,
"regions": [
{
"mean_per_day": 4.75,
"poor_population": 580628061,
"population": 1291044964,
"poverty_gap": 17.13,
"poverty_rate": 44.97,
"region": "Sub-Saharan Africa",
"region_code": "SSF",
"year": 2024
},
{
"mean_per_day": 6.99,
"poor_population": 42907376,
"population": 1677384532,
"poverty_gap": 0.35,
"poverty_rate": 2.56,
"region": "South Asia",
"region_code": "SAS",
"year": 2024
}
],
"world": {
"mean_per_day": 21.61,
"poor_population": 824298368,
"population": 8141808945,
"poverty_gap": 3.51,
"poverty_rate": 10.12,
"region": "World",
"region_code": "WLD",
"year": 2024
},
"year": 2024
}Get poverty estimates
Get the share and number of people living below a poverty line in one country, with inequality and average income, from the World Bank's Poverty and Inequality Platform. The latest survey year by default, or any year, or every year.
Inputs
- Country
countrytextRequired - Pick a country or group from the list, or type a name or an ISO code such as Kenya, KEN or KE.
- Year
yeartext - A year such as 2019, all for every year, or leave empty for the latest survey.
- Poverty line (US$ a day)
poverty_linenumber - The daily income or consumption, in 2021 US dollars adjusted for prices, that counts as poor. Defaults to 3.00, the international extreme poverty line; 4.20 and 8.30 are the lines for lower and upper middle income countries.From 0.01 to 1000.0. Default:
3.0. - Estimate years without a survey
fill_gapstrue/false - On, a year without a survey is estimated from the surveys around it and growth since. Off, only survey years are returned.Default:
false.
Outputs
countnumber- How many estimates there are.
countrytext- The country.
country_codetext- Its ISO 3 code.
estimateslist- Newest first.
poverty_linenumber- The poverty line, in US$ a day.
yeartext- The year asked for, all, or latest available.
Example output
{
"count": 1,
"country": "Brazil",
"country_code": "BRA",
"estimates": [
{
"estimate_type": "survey",
"gini_index": 50.26,
"is_interpolated": false,
"mean_per_day": 26.55,
"median_per_day": 16.91,
"poor_population": 6381157,
"population": 211998573,
"poverty_gap": 1.02,
"poverty_line": 3,
"poverty_rate": 3.01,
"reporting_level": "national",
"survey": "PNADC-E1",
"survey_year": 2024,
"welfare_type": "income",
"year": 2024
}
],
"poverty_line": 3.0,
"year": "latest available"
}List a topic's indicators
List the indicators filed under one topic, such as Education or Climate Change, by name. Lists the World Development Indicators ones unless you pick another database or every database.
Inputs
- Topic
topictextRequired - Pick a topic, or give its number from 'List topics'.
- Database
sourcetext - Which database's indicators to list. Leave empty for the World Development Indicators. Every database leaves out the WDI Database Archives, whose data can no longer be read.
- How many
limitnumber - The most indicators to return. Defaults to 100.From 1 to 1000. Default:
100.
Outputs
countnumber- How many are returned.
indicatorslist- The indicators, by name.
source_idtext- The database listed, or null for every database.
topictext- The topic's name.
topic_idtext- The topic's id.
totalnumber- How many indicators the topic holds there.
Example output
{
"count": 1,
"indicators": [
{
"code": "NY.GDP.PCAP.CD",
"description": "Gross domestic product is the total income earned through the production of goods and services in an economic territory during an accounting period.",
"name": "GDP per capita (current US$)",
"source": "World Development Indicators",
"source_id": "2",
"topics": [
"Economy & Growth"
],
"url": "https://data.worldbank.org/indicator/NY.GDP.PCAP.CD"
}
],
"source_id": "2",
"topic": "Economy & Growth",
"topic_id": "3",
"total": 253
}List countries
List the 217 economies the World Bank reports on, with each one's codes, region, income group, lending type and capital. Narrow the list to a region, income level or lending type, or include the regional and income groups as well.
Inputs
- Region or group
regiontext - Only countries in this region or group, such as South Asia or the European Union.
- Income level
income_leveltext - Only countries in this income group.One of:
LIC(Low income),LMC(Lower middle income),UMC(Upper middle income),HIC(High income),LMY(Low and middle income),MIC(Middle income),INX(Not classified). - Lending type
lending_typetext - Only countries that borrow from the World Bank this way.One of:
IBD(IBRD),IDB(Blend),IDX(IDA),LNX(Not classified). - Include regions and groups
include_aggregatestrue/false - On, the World Bank's regional and income groups, such as World, are listed after the countries.Default:
false.
Outputs
countnumber- How many are listed.
countrieslist- Countries by name, then any groups.
Example output
{
"count": 1,
"countries": [
{
"capital_city": "Nairobi",
"code": "KEN",
"income_level": "Lower middle income",
"income_level_code": "LMC",
"is_aggregate": false,
"iso2_code": "KE",
"latitude": -1.27975,
"lending_type": "Blend",
"lending_type_code": "IDB",
"longitude": 36.8126,
"name": "Kenya",
"region": "Sub-Saharan Africa",
"region_code": "SSF",
"url": "https://data.worldbank.org/country/ke"
}
]
}List databases
List the World Bank's databases, from the World Development Indicators to education, gender and debt statistics, with when each was last updated.
Inputs
None.
Outputs
countnumber- How many databases there are.
sourceslist- Every database, by id.
Example output
{
"count": 71,
"sources": [
{
"code": "WDI",
"has_data": true,
"has_metadata": true,
"id": "2",
"last_updated": "2026-07-13",
"name": "World Development Indicators"
},
{
"code": "WGI",
"has_data": true,
"has_metadata": true,
"id": "3",
"last_updated": "2026-09-25",
"name": "Worldwide Governance Indicators"
}
]
}List regions and groups
List the World Bank's seven geographic regions and the other country groups it reports on, such as the European Union and small states, with their codes.
Inputs
None.
Outputs
countnumber- How many are listed.
regionslist- The geographic regions first, then the other groups.
Example output
{
"count": 43,
"regions": [
{
"code": "EAS",
"is_geographic": true,
"iso2_code": "Z4",
"name": "East Asia & Pacific"
},
{
"code": "SSF",
"is_geographic": true,
"iso2_code": "ZG",
"name": "Sub-Saharan Africa"
}
]
}List topics
List the 21 subjects the World Bank files its indicators under, such as Health, Education and Poverty, with what each covers.
Inputs
None.
Outputs
countnumber- How many topics there are.
topicslist- Every topic, by id.
Example output
{
"count": 21,
"topics": [
{
"description": "For the 70 percent of the world's poor who live in rural areas, agriculture is the main source of income and employment.",
"id": "1",
"name": "Agriculture & Rural Development"
},
{
"description": "Economic growth is central to economic development.",
"id": "3",
"name": "Economy & Growth"
}
]
}Rank countries
The highest or lowest countries in the world on one indicator, with the world figure alongside. Regional and income groups are left out by default so the ranking is of countries, but they can be put back in. Without a year, each country is read at its most recent value from the last ten years.
Inputs
- Indicator
indicatortextRequired - What to measure. Pick a World Development Indicator from the list, or type any World Bank indicator code such as NY.GDP.MKTP.CD, including one found with 'Find indicators'.
- Year
yearnumber - Use each country's value for this year. Leave empty to use each country's most recent value, which can be a different year for each.From 1800 to 2100.
- Which end
ordertext - Whether to take the top of the ranking or the bottom.One of:
highest(The highest),lowest(The lowest). Default:highest. - How many
countnumber - How many countries to return.From 1 to 217. Default:
10. - Include regions and groups
include_aggregatestrue/false - On, groups such as Sub-Saharan Africa and High income are ranked alongside the countries.Default:
false. - Database
sourcetext - Which World Bank database to read. Leave empty for the World Development Indicators, or the indicator's own database when it is not one of them.
Outputs
as_oftext- The year ranked, or latest available.
countnumber- How many are returned.
countrieslist- The countries in rank order.
indicatortext- The indicator's name.
indicator_codetext- The indicator's code.
last_updatedtext- When that database was last updated (YYYY-MM-DD).
leadertext- The country ranked first.
leader_valuenumber- Its value.
ordertext- highest or lowest.
ranked_out_ofnumber- How many countries had a value to rank.
sourcetext- The name of that database.
source_idtext- The id of the database the figures came from.
worldobject- The world as a whole, when the World Bank reports it.
Example output
{
"as_of": "latest available",
"count": 3,
"countries": [
{
"country": "Monaco",
"country_code": "MCO",
"period": "2024",
"rank": 1,
"value": 86.497,
"year": 2024
},
{
"country": "San Marino",
"country_code": "SMR",
"period": "2024",
"rank": 2,
"value": 85.817,
"year": 2024
},
{
"country": "Hong Kong SAR, China",
"country_code": "HKG",
"period": "2024",
"rank": 3,
"value": 85.3926829268293,
"year": 2024
}
],
"indicator": "Life expectancy at birth, total (years)",
"indicator_code": "SP.DYN.LE00.IN",
"last_updated": "2026-07-13",
"leader": "Monaco",
"leader_value": 86.497,
"order": "highest",
"ranked_out_of": 217,
"source": "World Development Indicators",
"source_id": "2",
"world": {
"period": "2024",
"value": 73.4818184164654
}
}