# World Bank Open Data

> 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.

App · Research & Academia · 16 actions. Web page: https://docs.lodol.com/docs/integrations/world-bank

## Actions

### 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 (`indicator`, text, required): 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 (`countries`, list, required): 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 (`year`, number): 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 (`order`, text): 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 (`source`, text): 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_of` (text): The year compared, or latest available.
- `count` (number): How many countries had a value.
- `countries` (list): The countries in rank order.
- `indicator` (text): The indicator's name.
- `indicator_code` (text): The indicator's code.
- `last_updated` (text): When that database was last updated (YYYY-MM-DD).
- `leader` (text): The country ranked first.
- `leader_value` (number): Its value.
- `missing` (list): The countries with no value to compare.
- `order` (text): highest_first or lowest_first.
- `source` (text): The name of that database.
- `source_id` (text): The id of the database the figures came from.

**Example output**

```json
{
  "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 (`query`, text, required): A few words, or an indicator code.
- Database (`source`, text): 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 (`limit`, number): The most matches to return. Defaults to 20. From 1 to 100. Default: `20`.

**Outputs**

- `count` (number): How many are returned.
- `indicators` (list): The best matches first.
- `query` (text): The words searched for.
- `source_id` (text): The database searched, or null for every database.
- `total_matches` (number): How many indicators matched in all.

**Example output**

```json
{
  "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 (`country`, text, required): Pick a country or group from the list, or type a name or an ISO code such as Kenya, KEN or KE.

**Outputs**

- `capital_city` (text): Its capital city.
- `code` (text): The ISO 3 code, such as KEN.
- `income_level` (text): Its World Bank income group.
- `income_level_code` (text): The income group's code.
- `is_aggregate` (true/false): True for a group of countries, such as World.
- `iso2_code` (text): The ISO 2 code, such as KE.
- `latitude` (number): The capital's latitude.
- `lending_type` (text): How it borrows from the World Bank: IBRD, IDA or Blend.
- `lending_type_code` (text): The lending type's code.
- `longitude` (number): The capital's longitude.
- `name` (text): The World Bank's name for it.
- `region` (text): Its region, or null for a group of countries.
- `region_code` (text): The region's code.
- `url` (text): Its page on data.worldbank.org.

**Example output**

```json
{
  "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 (`country`, text, required): Pick a country or group from the list, or type a name or an ISO code such as Kenya, KEN or KE.
- Figures (`indicators`, list): 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 (`year`, number): Use the values for this year. Leave empty for each figure's most recent value. From 1800 to 2100.

**Outputs**

- `as_of` (text): The year used, or latest available.
- `count` (number): How many figures were asked for.
- `country` (text): The country.
- `country_code` (text): Its ISO 3 code.
- `found_count` (number): How many of them the country has.
- `indicators` (list): One entry per indicator, in the order asked for.
- `last_updated` (text): When that database was last updated (YYYY-MM-DD).
- `source` (text): The name of that database.
- `source_id` (text): The database the figures came from.

**Example output**

```json
{
  "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 (`indicator`, text, required): 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 (`country`, text, required): Pick a country or group from the list, or type a name or an ISO code such as Kenya, KEN or KE.
- Database (`source`, text): 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**

- `change` (number): The newest value minus the one before.
- `country` (text): The country.
- `country_code` (text): Its ISO 3 code.
- `formatted` (text): The value written out, such as US$ 30.77 trillion.
- `found` (true/false): False when the country has no value at all.
- `indicator` (text): The indicator's name.
- `indicator_code` (text): The indicator's code.
- `last_updated` (text): When that database was last updated (YYYY-MM-DD).
- `percent_change` (number): That change as a percentage of the one before.
- `period` (text): The period of the newest value.
- `previous_period` (text): The period of the value before it.
- `previous_value` (number): The value before it.
- `source` (text): The name of that database.
- `source_id` (text): The id of the database the figures came from.
- `url` (text): The indicator's page on data.worldbank.org.
- `value` (number): The newest value.
- `year` (number): That period's year.

**Example output**

```json
{
  "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 (`indicator`, text, required): 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 (`country`, text, required): 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_year`, number): The first year to include. Leave empty to start at 1960. From 1800 to 2100.
- To year (`end_year`, number): The last year to include. Leave empty for the latest available. From 1800 to 2100.
- Database (`source`, text): 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**

- `average` (number): The mean value.
- `average_annual_growth` (number): The compound growth per year, in percent.
- `change` (number): The last value minus the first.
- `count` (number): How many values there are.
- `country` (text): The country.
- `country_code` (text): Its ISO 3 code.
- `first_period` (text): The earliest period with a value.
- `first_value` (number): Its value.
- `indicator` (text): The indicator's name.
- `indicator_code` (text): The indicator's code.
- `last_period` (text): The latest period with a value.
- `last_updated` (text): When that database was last updated (YYYY-MM-DD).
- `last_value` (number): Its value.
- `maximum` (number): The highest value.
- `maximum_period` (text): When it was highest.
- `minimum` (number): The lowest value.
- `minimum_period` (text): When it was lowest.
- `percent_change` (number): That change as a percentage of the first value.
- `points` (list): Every value, oldest first.
- `source` (text): The name of that database.
- `source_id` (text): The id of the database the figures came from.

**Example output**

```json
{
  "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 (`indicator`, text, required): 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**

- `archived` (true/false): True when the indicator is in the WDI Database Archives, whose figures this API no longer serves.
- `code` (text): The indicator's code.
- `description` (text): The indicator's full definition.
- `name` (text): The indicator's name.
- `organization` (text): The organizations that collect the figures.
- `source` (text): The name of that database.
- `source_id` (text): The id of the database it belongs to.
- `topics` (list): The topics the indicator is filed under.
- `url` (text): Its page on data.worldbank.org, for WDI indicators.

**Example output**

```json
{
  "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 (`indicator`, text, required): 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 (`countries`, list): 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_year`, number): The first year to include. Leave empty to start at 1960. From 1800 to 2100.
- To year (`end_year`, number): The last year to include. Leave empty for the latest available. From 1800 to 2100.
- Frequency (`frequency`, text): 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 (`source`, text): 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_empty`, true/false): On by default: years with no reported value are left out. Off, they are included with a null value. Default: `true`.
- Maximum rows (`limit`, number): The most rows to return. Defaults to 1,000. From 1 to 20000. Default: `1000`.

**Outputs**

- `count` (number): How many are returned.
- `frequency` (text): annual, quarterly or monthly.
- `indicator` (text): The indicator's name.
- `indicator_code` (text): The indicator's code.
- `last_updated` (text): When that database was last updated (YYYY-MM-DD).
- `rows` (list): Country by country, newest period first.
- `source` (text): The name of that database.
- `source_id` (text): The id of the database the figures came from.
- `total_rows` (number): How many values matched in all.
- `truncated` (true/false): True when more matched than the limit allowed.
- `url` (text): The indicator's page on data.worldbank.org.

**Example output**

```json
{
  "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 (`year`, text): A year such as 2019, or leave empty for the latest year the World Bank has estimated.
- Poverty line (US$ a day) (`poverty_line`, number): 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**

- `count` (number): How many regions are listed.
- `poverty_line` (number): The poverty line, in US$ a day.
- `regions` (list): The regions, poorest first.
- `world` (object): The world as a whole.
- `year` (number): The year.

**Example output**

```json
{
  "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 (`country`, text, required): Pick a country or group from the list, or type a name or an ISO code such as Kenya, KEN or KE.
- Year (`year`, text): A year such as 2019, all for every year, or leave empty for the latest survey.
- Poverty line (US$ a day) (`poverty_line`, number): 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_gaps`, true/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**

- `count` (number): How many estimates there are.
- `country` (text): The country.
- `country_code` (text): Its ISO 3 code.
- `estimates` (list): Newest first.
- `poverty_line` (number): The poverty line, in US$ a day.
- `year` (text): The year asked for, all, or latest available.

**Example output**

```json
{
  "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 (`topic`, text, required): Pick a topic, or give its number from 'List topics'.
- Database (`source`, text): 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 (`limit`, number): The most indicators to return. Defaults to 100. From 1 to 1000. Default: `100`.

**Outputs**

- `count` (number): How many are returned.
- `indicators` (list): The indicators, by name.
- `source_id` (text): The database listed, or null for every database.
- `topic` (text): The topic's name.
- `topic_id` (text): The topic's id.
- `total` (number): How many indicators the topic holds there.

**Example output**

```json
{
  "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 (`region`, text): Only countries in this region or group, such as South Asia or the European Union.
- Income level (`income_level`, text): 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_type`, text): 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_aggregates`, true/false): On, the World Bank's regional and income groups, such as World, are listed after the countries. Default: `false`.

**Outputs**

- `count` (number): How many are listed.
- `countries` (list): Countries by name, then any groups.

**Example output**

```json
{
  "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**

- `count` (number): How many databases there are.
- `sources` (list): Every database, by id.

**Example output**

```json
{
  "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**

- `count` (number): How many are listed.
- `regions` (list): The geographic regions first, then the other groups.

**Example output**

```json
{
  "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**

- `count` (number): How many topics there are.
- `topics` (list): Every topic, by id.

**Example output**

```json
{
  "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 (`indicator`, text, required): 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 (`year`, number): 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 (`order`, text): Whether to take the top of the ranking or the bottom. One of: `highest` (The highest), `lowest` (The lowest). Default: `highest`.
- How many (`count`, number): How many countries to return. From 1 to 217. Default: `10`.
- Include regions and groups (`include_aggregates`, true/false): On, groups such as Sub-Saharan Africa and High income are ranked alongside the countries. Default: `false`.
- Database (`source`, text): 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_of` (text): The year ranked, or latest available.
- `count` (number): How many are returned.
- `countries` (list): The countries in rank order.
- `indicator` (text): The indicator's name.
- `indicator_code` (text): The indicator's code.
- `last_updated` (text): When that database was last updated (YYYY-MM-DD).
- `leader` (text): The country ranked first.
- `leader_value` (number): Its value.
- `order` (text): highest or lowest.
- `ranked_out_of` (number): How many countries had a value to rank.
- `source` (text): The name of that database.
- `source_id` (text): The id of the database the figures came from.
- `world` (object): The world as a whole, when the World Bank reports it.

**Example output**

```json
{
  "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
  }
}
```