Forcibly displaced and stateless populations, by origin and asylum country
End-of-year UNHCR population figures by country of origin and country of asylum: refugees, asylum-seekers, returned refugees, internally displaced persons (IDPs), returned IDPs, stateless persons, others of concern to UNHCR, other people in need of international protection, and host community members. Coverage from 1951; the provider marks missing observations with "-" (stored as null).
Source: UNHCR — Refugee Population Statistics Database1,111,299 rowsUpdated: 9/22/2026License: CC-BY-4.0
refugeesdisplacementmigrationasylumstatelessunhcridp
Quality
100
Attribution
UNHCR Refugee Population Statistics Database
Schema
| Column | Type | Description |
|---|---|---|
| date | timestamp | Reference year of the observation, mapped to January 1 of that year. UNHCR's population data are end-of-year figures; applications, decisions and solutions are annual totals for the reference year. |
| coo_name | string | Country of origin name (provider's wording). |
| coo | string | Country of origin UNHCR code. |
| coo_iso | string | Country of origin ISO code. |
| coa_name | string | Country of asylum name (provider's wording). |
| coa | string | Country of asylum UNHCR code. |
| coa_iso | string | Country of asylum ISO code. |
| series_id | string | Stable machine identifier built from the provider's own codes: UNHCR country-of-origin code, country-of-asylum code, and the measure or procedure-dimension codes (e.g. "AFG.AUL.refugees", "AFG.AUL.G.A.AR.C" for an asylum-applications row). |
| series_label | string | Human-readable series name using the provider's own country names, e.g. "Afghanistan → Australia — Refugees". |
| pop_type | string | UNHCR population group (provider's field name): refugees, asylum_seekers, returned_refugees, idps, returned_idps, stateless, ooc, oip, hst. |
| pop_type_label | string | Human label of the population group: Refugees (the number of refugees), Asylum-seekers (the number of asylum-seekers), Returned refugees (the number of returned refugees), Internally displaced persons (the number of internally displaced persons), Returned IDPs (the number of returned internally displaced persons), Stateless persons (the number of stateless persons), Others of concern to UNHCR (the number of others of concern to UNHCR), Other people in need of international protection (the number of other people in need of international protection), Host community members (the number of host community members). |
| unit | string | "persons": all measures are counts of people. For asylum applications/decisions the provider notes the data usually reflects persons but governments sometimes report cases (see app_pc/dec_pc); a case can contain one or more persons. |
| value | float | Observed count. The provider marks missing observations with "-"; these become null and are dropped from the canonical frame. |
Sample rows
| date | coo_name | coo | coo_iso | coa_name | coa | coa_iso | series_id | series_label | pop_type | pop_type_label | unit | value |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2021-01-01T00:00:00 | Aruba | ABW | ABW | Aruba | ABW | ABW | ABW.ABW.asylum_seekers | Aruba → Aruba — Asylum-seekers | asylum_seekers | Asylum-seekers | persons | 0 |
| 2022-01-01T00:00:00 | Aruba | ABW | ABW | Aruba | ABW | ABW | ABW.ABW.asylum_seekers | Aruba → Aruba — Asylum-seekers | asylum_seekers | Asylum-seekers | persons | 0 |
| 2021-01-01T00:00:00 | Aruba | ABW | ABW | Aruba | ABW | ABW | ABW.ABW.hst | Aruba → Aruba — Host community members | hst | Host community members | persons | 6000 |
| 2022-01-01T00:00:00 | Aruba | ABW | ABW | Aruba | ABW | ABW | ABW.ABW.hst | Aruba → Aruba — Host community members | hst | Host community members | persons | 1700 |
| 2021-01-01T00:00:00 | Aruba | ABW | ABW | Aruba | ABW | ABW | ABW.ABW.idps | Aruba → Aruba — Internally displaced persons | idps | Internally displaced persons | persons | 0 |
Download sample data
Download the full sample snapshot for this dataset (sample rows, not the complete dataset).
Use with an LLM
Point any LLM at the metadata endpoint — the documentation above is machine-readable too (JSON-LD + Croissant).
cURL
curl "https://datazimuts.com/v1/datasets/unhcr/unhcr_displaced_population" | jq '{title, rows, columns_count, license}'Python
import requests
ds = requests.get("https://datazimuts.com/v1/datasets/unhcr/unhcr_displaced_population").json()
print(ds["title"], ds["rows"], "rows")
# Sample rows for an LLM context window
for row in ds.get("sample_rows", [])[:5]:
print(row)API endpoint: https://datazimuts.com/v1/datasets/unhcr/unhcr_displaced_population
Tip: fetch /llms.txt for the full machine-readable catalog.