Environment

CO2 breakdown by source for one country

Changed on

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}

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/environment/co2/sources/{iso3}
  • Auth: API key in header x-api-key

Path parameters

iso3string required

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.

end_yearinteger nullable

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",
    "data_age_days": 8.532,
    "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"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes