Retrieve a data.table, data.frame of UNHCR Populations of Concern Time Series (2014-2019) Demographic data from the official UNHCR API.

getUNdem()

Value

A data.table, data.frame.

Data Structure

Based on limited availability of metadata, the Demographic Populations of Concern Time Series dataset columns are as follows:

year

The year of record for the observations.

coo_id

UNHCR numeric country code for the country of origin.

coo_name

The UNHCR name of applicantss country of origin.

coo

UNHCR character country code for the country of origin.

coo_iso

ISO3C country code for the country of origin.

coa_id

UNHCR numeric country code for the country of asylum.

coa_name

The UNHCR name of the applicants country of asylum.

coa

UNHCR character country code for the country of asylum.

coa_iso

ISO3C country code for the country of asylum.

location

It's unclear what this field is for, every entry is blank.

loc_typeIt's unclear what this field is for, every entry is blank. acc_typeIt's unclear what this field is for, every entry is NULL.
pop_type

Population type. See below.

f_0_4

Females aged 0-4 years old.

f_5_11

Females aged 5-11 years old.

f_12_17

Females aged 12-17 years old.

f_18_59

Females aged 18-59 years old.

f_60

Females aged 60 years older.

f_other

Other? females of concern.

f_total

Total females.

m_0_4

Males aged 0-4 years old.

m_5_11

Males aged 5-11 years old.

m_12_17

Males aged 12-17 years old.

m_18_59

Males aged 18-59 years old.

m_60

Males aged 60 years older.

m_other

Other? males of concern.

m_total

Total males.

total

Total males and females.

Population Designations

The United Nations High Commissioner for Refugees (UNHCR) Populations of Concern Time Series dataset contains annual dyadic flows between countries for populations of concern. This dataset tracks 8 distinct populations:

Refugees (REF)

These are individuals recognized under the Geneva Convention of 1951 as refugees or persons in "refugee like situations." These persons are defined as 1) being present outside of their home country, 2) have a well-founded fear of persecution, and 3) lack the protection of their own country.

Asylum-seekers (ASY)

Individuals seeking international protection, but whose refugee status has yet to be verified.

Internally Displaced Persons (IDP)

Individuals or groups of people forced from their home as a result of armed conflict, natural or man-made disasters, or human rights violations, but have not crossed an international border.This group of IDPs are tracked by UNHCR and differ from estimates available from the Global Internal Displacement Database (GIDD), which is also available from the UNHCR Data Finder

Venezuelans Displaced Abroad (VDA)

persons of Venezuelan origin who are likely to be in need of international protection under the criteria contained in the Cartagena Declaration, but who have not applied for asylum in the country in which they are present.

Stateless Persons (STA)

Individuals defined under international law not considered as belonging to any Nation-State.

Others of Concern (OOC)

Individuals who are not covered by any of the aforementioned legal declarations, but are under UNHCR protection or receiving UNHCR assistance.

Returned IDPs RDP

Returned internally displaced persons. Only 2 observations have this designation in the demographic dataset (Liberia 2006 and Afghanistan 2004).

Returned Refugees RET

Returned refugees. There are 142 observations with this designation in the demographic dataset.