Aggregate greenhouse-gas time series for a named region

GET

/api/v1/environment/co2/region/{region}

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

Maintainer:Not configured

OperationId:environment_co2_region_region

Returns every column in the OWID CO2 bundle for a named aggregate entity. Supported regions include continental groupings (Africa, Asia, Europe, North America, Oceania, South America), the European Union (27-member and 28-member compositions), OECD and non-OECD groupings, World Bank income groupings (High-income, Upper-middle-income, Lower-middle-income, Low-income), sectoral aggregates (International aviation, International shipping), and (GCP) variants provided by the Global Carbon Project. Call /catalog for the full allowlist of valid region names. Published under CC BY 4.0 with dual attribution to Our World in Data and the primary upstream providers.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

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

Path Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Aggregate time series across all 79 columns for the requested region.

Bodyapplication/json

Example

{
    "data": {
        "region": "European Union (27)",
        "observations": [
            {
                "year": 2022,
                "property1": "string",
                "property2": "string"
            }
        ],
        "count": 74,
        "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

Full column dictionary for the OWID CO2 bundle

CO2 breakdown by source for one country