← ALL DATASETS
DATASET / worldbank_income_classification_history / V20261008

World Bank income classification by country, historical

The income group the World Bank assigned to each economy every 1 July, based on GNI per capita (Atlas method) for the previous calendar year. Follow when countries moved up or down the income ladder, or compare the official group with GNI per capita and the published thresholds.

OPEN IN QUERY ↗income / classification / GNI per capita / World Bank / time series
SOURCEWorld Bank ↗
GEOGRAPHY215 ISO 3166-1 alpha-3 countries/territories; 9 non-ISO, former or non-WDI entities excluded
TIME1987–2025 GNI data years (FY89–FY27)
UPDATED2026-11-08

VISUAL EXPLORATION

Table preview is the curated default for this dataset.

TABLE PREVIEW

Loading preview…

METADATA

DATA DICTIONARY

country_iso_alpha3ISO 3166-1 alpha-3 code · string · identifier

Reviewed three-letter ISO country or territory identifier.

country_nameCountry or territory · string · dimension

Reviewed display name for the ISO code.

yearGNI data year · integer · dimension

Calendar year of the GNI per capita data on which the classification is based.

fiscal_yearWorld Bank fiscal year · string · dimension

World Bank fiscal year (1 July–30 June) during which the classification was in force, labelled by the calendar year in which it ends.

income_group_codeIncome group code · string · dimension

World Bank short code for the income group: L = low, LM = lower middle, UM = upper middle, H = high income.

income_groupIncome group · string · dimension

World Bank analytical income group in force for the fiscal year.

classification_statusClassification status · string · dimension

Whether the economy was classified for the fiscal year: classified; not_available (source '..'); unclassified (source cell left blank).

PROVENANCE & LIMITATIONS

Official World Bank OGHIST workbook (OGHIST_2026_10_08.xlsx, supplied by the human on 2026-11-08, SHA-256 a4024eb8052150155034559daf053aabbc16336d8290efeb5629e6eeb6515a60), worksheet 'Country Analytical History'. 224 source entities × 39 fiscal years. Retained 215 codes in the reviewed mappings/worldbank_wdi_entities_20261008_un_m49.csv; excluded 9: CHI (Channel Islands), XKX (Kosovo), TWN (Taiwan, China), CSK (Czechoslovakia (former)), MYT (Mayotte), ANT (Netherlands Antilles (former)), YUG (Serbia and Montenegro (former)), SUN (USSR (former)), YUGf (Yugoslavia (former)). 8385 rows: 7933 classified, 446 '..' → not_available, 6 blank → unclassified (ETH FY26, VEN FY22, VEN FY23, VEN FY24, VEN FY25, VEN FY26). Yemen 'LM*' FY89–FY90 stored as LM per source footnote and human decision 0013.

Processing code: pipeline/sources/worldbank/process-income-history.py

  • `year` is the calendar year of the GNI data; the group applied for the World Bank fiscal year starting the following 1 July (`fiscal_year` = year + 2). It joins directly with GNI per capita and the threshold table on `year`.
  • Groups are as published each 1 July and are not revised later; recomputing them from current, revised GNI estimates can give a different group in some years.
  • Not classified cells are null with a status: 'not_available' where the source shows '..' (typically before an economy had data or existed in its current form) and 'unclassified' where the source cell is blank (ETH FY26, VEN FY22, VEN FY23, VEN FY24, VEN FY25, VEN FY26).
  • Yemen FY89–FY90 ('LM*' in the source) is stored as Lower middle income: at that time Yemen, PDR was low income and Yemen, Arab Rep. lower-middle income, combined LM per the World Bank footnote.
  • Excluded entities: CHI (Channel Islands), XKX (Kosovo), TWN (Taiwan, China), CSK (Czechoslovakia (former)), MYT (Mayotte), ANT (Netherlands Antilles (former)), YUG (Serbia and Montenegro (former)), SUN (USSR (former)), YUGf (Yugoslavia (former)). Former states have no ISO 3166-1 code; the others are outside the reviewed WDI ISO mapping. They remain in the raw workbook.
  • ISO 3166-1 includes dependent territories; this package is not limited to sovereign states.