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.

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

Changes

Changed in 2 of the 22 revisions of this API.15

Sep 1, 2026328d061c12ca3See the full diff
- ○
  added the optional property meta/data_age_days to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/notes to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/period to the response with the 200 status
  response-optional-property-added
Aug 8, 20264c4530760ba112See the full diff
- ○
  added the optional property code to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 503 status
  response-optional-property-added

Full history