Skip to content
Branch: master
Go to file

Latest commit


Failed to load latest commit information.
Latest commit message
Commit time

Data Package with UNFCCC emissions data, downloaded from the UNFCCC "Detailed Data By Party" interface.




The data is available in two files, one for Annex-I and one for Non-Annex-I parties. Is is in a "wide" format, with base year and individual years as columns.

According to the overview webpage the interface contains data

reported by Annex I Parties and, to the extent possible, information provided in the national communications and biennial update reports of non-Annex I Parties as of 27 May 2019.

Note also the following footnotes from the data interface:

The reporting and review requirements for GHG inventories are different for Annex I and non-Annex I Parties. The definition format of data for emissions/removals from the forestry sector is different for Annex I and non-Annex I Parties.

Base year data in the data interface relate to the base year under the Climate Change Convention (UNFCCC). The base year under the Convention is defined slightly different than the base year under the Kyoto Protocol. An exception is made for European Union (KP) whereby the base year under the Kyoto Protocol is displayed.

Some non-Annex I Parties submitted their GHG inventory data using the format of the 2006 IPCC Guidelines in reporting GHG emissions/removals. For this reason, these data could not be included in the data interface. However, the data are available in the national communications (Andorra, Antigua and Barbuda, Armenia, Bangladesh, Brunei Darussalam, Cabo Verde, Côte d'Ivoire, Colombia, Eswatini, Ghana, Indonesia, Jamaica, Kiribati, Malaysia, Mauritania, Mauritius, Mexico, Mongolia, Namibia, Panama, Republic of Moldova, Rwanda, Samoa, Serbia, Sierra Leone, Singapore, Somalia, Suriname, United Arab Emirates, Venezuela and Viet Nam) and biennial update reports (Andorra, Argentina, Armenia, Azerbaijan, Chile, Colombia, Costa Rica, El Salvador, Ghana, India, Indonesia, Jordan, The Former Yugoslav Republic of Macedonia, Malaysia, Mauritania, Mexico, Mongolia, Montenegro, Namibia, Nigeria, Panama, Paraguay, Republic of Moldova, Serbia, Singapore, South Africa, Togo, Tunisia and Uruguay).

Data displayed on the data interface are "as received" from Parties. The publication of Party submissions on this website does not imply the expression of any opinion whatsoever on the part of the UNFCCC or the Secretariat of the United Nations concerning the legal status of any country, territory, city or area or of its authorities, or concerning the delimitation of its frontiers or boundaries as may be referred to in any of the submissions.


To update the dataset once updates become available, the following steps need to be run. It might be necessary to adjust the scripts if the data format or website changes. Python3 and Make are required. The process should run on Linux or macOS.


make mappings

to download category and group mappings,

make download

to download the data as JSON files and

make process

to generate CSV files for Annex-I and Non-Annex-I.

To remove all downloaded and generated files run

make clean

This needs to be done to check for updated data. To continue an interrupted download or check for new data simply re-run make download. Files already downloaded are skipped.


The UNFCCC website states:

All official texts, data and documents are in the public domain and may be freely downloaded, copied and printed provided no change to the content is introduced, and the source is acknowledged.

You can’t perform that action at this time.