v5

latestOpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Environment

World aggregate greenhouse-gas time series

Returns every column in the OWID CO2 bundle for the World entity - the harmonised global aggregate. Covers global CO2 totals, CO2 by source, consumption emissions, cumulative CO2 since 1750, methane, nitrous oxide, total greenhouse gases, global temperature-change contributions, and energy aggregates. For continent- or income-group aggregates (Asia, Africa, OECD, EU27, High-income countries) use /region/{region}. Published under CC BY 4.0 with dual attribution to Our World in Data and the primary upstream providers.

get/api/v1/environment/co2/world

Query parameters

start_yearinteger nullable

Inclusive start year (integer). Bundle range is 1750-present.

Inclusive start year (integer). Bundle range is 1750-present.

end_yearinteger nullable

Inclusive end year. Defaults to the latest year in the bundle.

Inclusive end year. Defaults to the latest year in the bundle.

Response

Global aggregate across all 79 columns as an annual time series, plus attribution.

Example response

{
  "data": {
    "region": "World",
    "observations": [
      {
        "year": 2022
      }
    ],
    "count": 275,
    "start_year": 2000,
    "end_year": 2023
  },
  "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": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}