Full column dictionary for the OWID CO2 bundle

GET

/api/v1/environment/co2/codebook

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

Maintainer:Not configured

OperationId:environment_co2_codebook

Returns the column dictionary shipped with the bundle - one row per column with title, description, unit, and the primary upstream source. The codebook is OWID's authoritative schema definition and is the correct place to discover available metrics, their units, and methodological caveats before using them in /country/{iso3}/{metric} or /top. Published under CC BY 4.0 with dual attribution to Our World in Data and the primary upstream providers named per column.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

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

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Column dictionary with title, description, unit, and source per column.

Bodyapplication/json

Example

{
    "data": {
        "columns": [
            {
                "column": "co2",
                "title": "string",
                "description": "string",
                "unit": "string",
                "source": "string"
            }
        ],
        "count": 79,
        "dataset_last_modified": "string",
        "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

🟠429

🔴503

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

Top N emitters ranked by a metric for a given year

Aggregate greenhouse-gas time series for a named region