Sign in

v5

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

CO2 breakdown by source for one country

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.

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

Path parameters

iso3string required

ISO 3166-1 alpha-3 country code. Case-insensitive; normalised to uppercase.

ISO 3166-1 alpha-3 country code. Case-insensitive; normalised to uppercase.

Query parameters

start_yearinteger nullable

Inclusive start year (integer). Bundle range is 1750-present; source columns populate from 1850 onwards.

Inclusive start year (integer). Bundle range is 1750-present; source columns populate from 1850 onwards.

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

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

Example response

{
  "data": {
    "iso_code": "USA",
    "country": "United States",
    "observations": [
      {
        "year": 2022
      }
    ],
    "count": 100
  },
  "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"
    ]
  }
}