{"openapi":"3.1.0","info":{"title":"Greenhouse Gas Emissions API","version":"1.0.0","description":"Independent greenhouse-gas emissions data as an API — powered by Climate TRACE, the coalition (backed by Al Gore) that monitors global emissions from satellites, sensors and AI rather than self-reported figures. Get any country's emissions for a given year — CO2, methane (CH4) and nitrous oxide (N2O) in tonnes, plus CO2-equivalent over 100- and 20-year horizons — together with the country's global emissions rank and its share of total world emissions; pass several countries at once to compare them side by side. List the full set of sectors, subsectors and gases that Climate TRACE tracks (power, transportation, manufacturing, agriculture, fossil-fuel operations, waste and more). From China and the United States to any nation on Earth, with data from 2015 onward, it is ideal for climate, ESG, sustainability, policy, journalism and research applications. An independent emissions-inventory data source — distinct from electricity-grid carbon intensity, activity footprint calculators and climate classification. Open data from Climate TRACE (CC BY 4.0).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/climatetrace-api","description":"oanor gateway"}],"tags":[{"name":"Emissions"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/country":{"get":{"operationId":"get_v1_country","tags":["Emissions"],"summary":"A country's GHG emissions for a year","description":"","parameters":[{"name":"country","in":"query","required":false,"description":"ISO-3 code(s), comma-separated","schema":{"type":"string"},"example":"USA"},{"name":"year","in":"query","required":false,"description":"Year 2015-2024 (default 2022)","schema":{"type":"string"},"example":"2022"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"year":2022,"count":1,"countries":[{"rank":2,"country":"USA","emissions":{"ch4_t":37690016,"co2_t":5403442404,"n2o_t":677321,"co2e_20yr_t":9096074557,"co2e_100yr_t":6911308569},"previous_rank":2,"world_share_co2e_percent":11.8}]},"meta":{"timestamp":"2026-06-01T16:23:00.197Z","request_id":"7df7f2fb-7ab2-4ae4-addc-ebdcf3e2d9ea"},"status":"ok","message":"Country emissions retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/sectors":{"get":{"operationId":"get_v1_sectors","tags":["Emissions"],"summary":"Sectors, subsectors & gases covered","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"gases":["bc","c10f18","c2f6","c3f8","c4f10","c5f12","c6f14","c6h6","c-c3f6","c-c4f8","cf4","cfcs","ch2o","ch3oh","ch4","co","co2","co2e","co2e_100yr","co2e_20yr","h2s","hcfc-141b","hcfc-142b","hcs","hfc-125","hfc-134","hfc-134a","hfc-143","hfc-143a","hfc-152","hfc-152a","hfc-161","hfc-227ea","hfc-23","hfc-236cb","hfc-236ea","hfc-236fa","hfc-245ca","hfc-245fa","hfc-32","hfc-365mfc","hfc-41","hfc-43-10-mee","hfcs","hg","n2o","nf3","nh3","nmvoc","no2","nox","o3","oc","pahs","pb","pfcs","pm10","pm2_5","sf6","so2","sox","vocs"],"sectors":["manufacturing","mineral-extraction","waste","fossil-fuel-operations","agriculture","power","fluorinated-gases","transportation","forestry-and-land-use","buildings"],"subsectors":["aluminum","bauxite-mining","biological-treatment-of-solid-waste-and-biogenic","cement","chemicals","coal-mining","copper-mining","cropland-fires","crop-residues","domestic-aviation","domestic-shipping","domestic-wastewater-treatment-and-discharge","electricity-generation","enteric-fermentation-cattle-operation","enteric-fermentation-cattle-pasture","enteric-fermentation-other","fluorinated-gases","food-beverage-tobacco","forest-land-clearing","forest-land-degradation","forest-land-fires","glass","heat-plants","incineration-and-open-burning-of-waste","industrial-wastewater-treatment-and-discharge","international-aviation","international-shipping","iron-and-steel","iron-mining","lime","manure-applied-to-soils","manure-left-on-pasture-cattle","manure-management-cattle-operation","manure-management-other","net-forest-land","net-shrubgrass","net-soil-organic-carbon","net-wetland","non-broadcasting-vessels","non-residential-onsite-fuel-usage","oil-and-gas-production","oil-and-gas-refining","oil-and-gas-transport","other-agricultural-soil-emissions","other-chemicals","other-energy-use","other-fossil-fuel-operations","other-manufacturing","other-metals","other-mining-quarrying","other-onsite-fuel-usage","other-solid-fuels","other-transport","petrochemical-steam-cracking","pulp-and-paper","railways","removals","residential-onsite-fuel-usage","rice-cultivation","road-transportation","rock-quarrying","sand-quarrying","shrubgrass-fires","solid-waste-disposal","synthetic-fertilizer-application","textiles-leather-apparel","water-reservoirs","wetland-fires","wood-and-wood-products"]},"meta":{"timestamp":"2026-06-01T16:23:00.990Z","request_id":"be3d2c3f-e35f-4514-a505-fb58e1fa3992"},"status":"ok","message":"Sectors retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Endpoint catalogue & notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Climate TRACE is an independent inventory of global greenhouse-gas emissions, built from satellites, sensors and AI rather than self-reported figures. /v1/country?country=USA = a country's emissions for a year (default 2022; set year=2015..2024) — CO2, CH4 and N2O in tonnes, plus CO2-equivalent over 100- and 20-year horizons, the country's global emissions rank and its share of world emissions; pass several countries (country=USA,CHN,DEU, up to 15) to compare. /v1/sectors = the sectors, subsectors and gases that Climate TRACE covers. Country codes are ISO-3166 alpha-3 (USA, CHN, DEU); emissions are in tonnes. Data from Climate TRACE (CC BY 4.0). An emissions-inventory data source — distinct from electricity-grid carbon intensity, activity footprint calculators and climate classification. Ideal for climate, ESG, sustainability, policy and research applications.","years":"2015-2024","source":"Climate TRACE — independent GHG emissions inventory (climatetrace.org)","endpoints":["/v1/country","/v1/sectors","/v1/meta"]},"meta":{"timestamp":"2026-06-01T16:23:01.076Z","request_id":"332a2ff3-197b-4207-9822-e4da91ce6e2a"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3200,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":750,"monthly_call_quota":62000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2380,"monthly_call_quota":290000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6250,"monthly_call_quota":1000000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/climatetrace-api"}