Skip to content
Common Operational Datasets

COD-AB metadata

One row per country release, written as a metadata table inside each candidate GDB. Columns MUST appear in this order. An empty value means unknown. All COD-AB data is published under CC BY-IGO.

ColumnTypeRequiredDescription
country_nametextyesCountry name in English
country_iso2textyesISO 3166-1 alpha-2, uppercase
country_iso3textyesISO 3166-1 alpha-3, uppercase
versiontextyesRelease version, v01, v02, …
admin_level_fullintegeryesDeepest level covering the whole country
admin_level_maxintegeryesDeepest level in the data
admin_1_name … admin_5_nametextnoConcept name of each level (Province, District), not a unit name
admin_1_count … admin_5_countintegerup to admin_level_maxNumber of units per level, empty beyond admin_level_max
admin_notestextnoNotes on levels, codes and names
date_sourcedatenoLatest edit date published by any source layer
date_updateddatenoDate the contributor last updated the dataset
date_revieweddatenoDate OCHA last reviewed the dataset
date_metadatadateyesDate this record was written
date_valid_ondatenoDate from which this version is valid
date_valid_todatenoDate this version was superseded, empty while current
update_frequencyintegeryesYears between source updates, 1 or 2
update_typetextyesmajor, or minor when no boundary changed
sourcetextyesOrganisation(s) that produced the data
source_urltextnoURL of each source layer, ; -separated, coarsest level first, empty for data handed over without a download URL
contributortextyesOCHA office or team that processed the data
methodology_datasettextyesHow the data was obtained and processed, including licence attribution conditions
methodology_pcodestextnoHow codes were assigned
caveatstextnoLimits a data user should know

Dates are YYYY-MM-DD. admin_level_full MUST NOT exceed admin_level_max.