CO2 breakdown by source for one country

GET

/api/v1/environment/co2/sources/{iso3}

Last modified:2026-05-10 09:22:39

Maintainer:Not configured

OperationId:environment_co2_sources_iso3

Returns annual CO2 emissions by source for one ISO 3166-1 alpha-3 coded country. Sources: coal, oil, natural gas, cement, gas flaring, other industrial processes, and land-use change. Values are in million tonnes of CO2 per year. Land-use change can be negative for countries with net forest sequestration. Compiled by the Global Carbon Project (Global Carbon Budget 2025) and redistributed by Our World in Data. Published under CC BY 4.0 with dual attribution.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/environment/co2/sources/USA?start_year=1990&end_year=2023' \
--header 'x-api-key: <api-key>'

Responses

🟢200

application/json

Annual CO2 breakdown by fossil source and land-use change.

Bodyapplication/json

Example

{
    "data": {
        "iso_code": "USA",
        "country": "string",
        "unit": "million tonnes of CO2 per year",
        "observations": [
            {
                "year": 2022,
                "coal": 0,
                "oil": 0,
                "gas": 0,
                "cement": 0,
                "flaring": 0,
                "other_industry": 0,
                "land_use_change": 0
            }
        ],
        "count": 100,
        "attribution": "string"
    },
    "meta": {
        "endpoint": "/api/v1/fred/us/cpi",
        "data_time": "2026-04-16T14:30:00Z",
        "response_time": "2026-04-16T14:30:12Z",
        "provider": "Sugra API v1.0.1",
        "source": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true
    }
}

🟠401

🟠422

🟠429

🔴503

Modified at 2026-05-10 09:22:39

Aggregate greenhouse-gas time series for a named region

Contribution of one country to observed global warming