Overview The Displacement Service provides APIs for global displacement and refugee data from the United Nations High Commissioner for Refugees (UNHCR). Track refugee flows, internally displaced persons (IDPs), asylum seekers, and population exposure estimates.
Base Path: /api/displacement/v1GetDisplacementSummary Retrieves global refugee and IDP statistics from UNHCR.
Endpoint: GET /api/displacement/v1/get-displacement-summaryRequest Parameters Data year to retrieve (e.g., 2023). Uses latest available if zero or omitted.
Maximum number of country entries to return.
Maximum number of displacement flows to return.
Response The displacement summary. Global totals across all categories. Show GlobalDisplacementTotals
Total recognized refugees worldwide.
Total asylum seekers worldwide.
Total internally displaced persons worldwide.
Total stateless persons worldwide.
Grand total of displaced persons.
Per-country displacement breakdowns. ISO 3166-1 alpha-2 country code.
Refugees originating from this country.
Asylum seekers from this country.
Internally displaced persons within this country.
Stateless persons associated with this country.
Total displaced from this country.
Refugees hosted by this country.
Asylum seekers hosted by this country.
Total persons hosted by this country.
Representative location for mapping.
Top displacement flows between countries. ISO 3166-1 alpha-2 code of the origin country.
ISO 3166-1 alpha-2 code of the asylum country.
Number of refugees in this flow.
Origin country representative location.
Asylum country representative location.
Example Request curl -X GET "https://api.worldmonitor.com/api/displacement/v1/get-displacement-summary?year=2023&country_limit=10&flow_limit=20"
Example Response { "summary" : { "year" : 2023 , "global_totals" : { "refugees" : 35800000 , "asylum_seekers" : 6400000 , "idps" : 62500000 , "stateless" : 4900000 , "total" : 109600000 }, "countries" : [ { "code" : "SY" , "name" : "Syria" , "refugees" : 6800000 , "asylum_seekers" : 120000 , "idps" : 6900000 , "stateless" : 0 , "total_displaced" : 13820000 , "host_refugees" : 0 , "host_asylum_seekers" : 0 , "host_total" : 0 , "location" : { "latitude" : 34.8021 , "longitude" : 38.9968 } }, { "code" : "TR" , "name" : "Turkey" , "refugees" : 0 , "asylum_seekers" : 0 , "idps" : 0 , "stateless" : 0 , "total_displaced" : 0 , "host_refugees" : 3600000 , "host_asylum_seekers" : 125000 , "host_total" : 3725000 , "location" : { "latitude" : 38.9637 , "longitude" : 35.2433 } } ], "top_flows" : [ { "origin_code" : "SY" , "origin_name" : "Syria" , "asylum_code" : "TR" , "asylum_name" : "Turkey" , "refugees" : 3600000 , "origin_location" : { "latitude" : 34.8021 , "longitude" : 38.9968 }, "asylum_location" : { "latitude" : 38.9637 , "longitude" : 35.2433 } } ] } }
GetPopulationExposure Returns country population data or estimates population within a radius.
Endpoint: GET /api/displacement/v1/get-population-exposureRequest Parameters Mode: countries (default) or exposure.
Latitude (required for exposure mode). Range: -90 to 90.
Longitude (required for exposure mode). Range: -180 to 180.
Radius in km (required for exposure mode, defaults to 50).
Response True if the request succeeded.
Countries list (populated in countries mode). Show CountryPopulationEntry
ISO 3166-1 alpha-3 country code.
Population density per square kilometer.
Exposure result (populated in exposure mode). Estimated exposed population.
Radius used for the estimate in km.
ISO3 code of nearest priority country.
Population density used for the estimate.
Example Request (Countries Mode) curl -X GET "https://api.worldmonitor.com/api/displacement/v1/get-population-exposure?mode=countries"
Example Response (Countries Mode) { "success" : true , "countries" : [ { "code" : "CHN" , "name" : "China" , "population" : 1425671352 , "density_per_km2" : 153 }, { "code" : "IND" , "name" : "India" , "population" : 1428627663 , "density_per_km2" : 464 } ] }
Example Request (Exposure Mode) curl -X GET "https://api.worldmonitor.com/api/displacement/v1/get-population-exposure?mode=exposure&lat=33.5138&lon=36.2765&radius=100"
Example Response (Exposure Mode) { "success" : true , "exposure" : { "exposed_population" : 2850000 , "exposure_radius_km" : 100 , "nearest_country" : "SYR" , "density_per_km2" : 91 } }
Displacement Categories
Refugees People who have fled their country due to persecution, war, or violence.
Asylum Seekers People who have applied for international protection but whose claims are pending.
IDPs Internally Displaced Persons who have fled their homes but remain within their country.
Stateless People who are not recognized as citizens by any country.
Data Source Displacement data is sourced from:
UNHCR : United Nations High Commissioner for RefugeesGlobal Trends Report : Annual statistical yearbookPopulation Data : World Bank and national statisticsUpdated annually with mid-year estimates available