Location

Location is an entity that describes country, non-sovereign region, principal administrative unit of a country (e.g., state, province), GBD region, or other custom administrative division, such as World Bank Income Level or WHO region.

Properties

Property	Type	Description
id	int	Unique location identifier
name	string	Location name
location_type_id	int	Location type id, see the table below
level	int	Location level in the location hierarchy
level0_parent_id	int	Level 0 parent location identifier
level1_parent_id	int	Level 1 parent location identifier
level2_parent_id	int	Level 2 parent location identifier
level3_parent_id	int	Level 3 parent location identifier
level4_parent_id	int	Level 4 parent location identifier
level5_parent_id	int	Level 5 parent location identifier
level6_parent_id	int	Level 6 parent location identifier

The following location types are available:

Id	Name	Description
1	Global	The whole world
2	Admin 0	Zero level administrative unit (Country)
3	Admin 1	First level administrative unit
4	Admin 2	Second level administrative unit
9	Admin 3	Third level administrative unit
16	Heaths district
6	Region	Regions based on two criteria: epidemiological similarity and geographic closeness
7	Super region	Groups of regions on the basis of cause of death patterns
8	Non-sovereign	Non-sovereign locations

Example

{
    "id": 6,
    "name": "China",
    "location_type_id": 2,
    "level": 3,
    "level0_parent_id": 1,
    "level1_parent_id": 4,
    "level2_parent_id": 5,
    "level3_parent_id": 0,
    "level4_parent_id": 0,
    "level5_parent_id": 0,
    "level6_parent_id": 0
}

Endpoints

The Location entity has the following endpoints:

• Get locations