UnifyAPI
← Back to catalog

unhcr.population

mock data$0.001 / call

UNHCR Refugee & Displacement Statistics

Get UNHCR global or per-country refugee and displaced-person population statistics (1951–present). Returns refugee counts, asylum seekers, internally displaced persons (IDPs), stateless persons, other people of concern (OOC), other in need of protection (OIP), and host community (HST) figures. Filter by year (e.g. 2023), country of origin ISO3 code (e.g. SYR for Syria, AFG for Afghanistan, UKR for Ukraine), or country of asylum ISO3 (e.g. DEU, TUR, COL). Omit all filters for global aggregates across all years. Paginated; default 10 items. UNHCR Data License — open humanitarian data, no upstream cost.

Referenceprovider: Unhcr#unhcr#reference

Input schema

coa

ISO 3-letter country code for country of asylum, e.g. DEU (Germany), TUR (Turkey), COL (Colombia). Omit to include all asylum countries.

string
coo

ISO 3-letter country code for country of origin, e.g. SYR (Syria), AFG (Afghanistan), UKR (Ukraine). Omit to include all origin countries.

string
year

Reference year for the statistics (1951–present). Omit to return all years (paginated).

integer
limit

Number of records to return per page (1–100, default 10).

integer

Call via REST

curl -X POST https://unifyapi.pro/api/call/unhcr.population \
  -H "Authorization: Bearer uak_live_..." \
  -H "Content-Type: application/json" \
  -d '{"coa":"<coa>","coo":"<coo>","year":0,"limit":0}'

Try it

Paste a UnifyAPI key (create one in the dashboard) and run a real call.