v5

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

Rank asset-level emission sources by emissions

List asset-level emission sources (power plants, refineries, cement kilns, steel mills, shipping vessels, aviation, forestry flux, and more) filtered by year, gas, sector, subsector, admin area, city, country group, continent, or owner entities. Results are ranked by reported emissions. Use /sources/{source_id} for a single-asset drill-down with monthly time series. Data sourced from Climate TRACE under CC BY 4.0.

get/api/v1/environment/ct/sources

Query parameters

yearinteger

Calendar year of the emissions snapshot. Inventory covers 2015 through the current year.

Calendar year of the emissions snapshot. Inventory covers 2015 through the current year.

gasstring

Gas identifier from /definitions/gases.

Gas identifier from /definitions/gases.

sectorsstring nullable

Comma-separated sector slugs. Use all_no_forest to exclude forestry-and-land-use.

Comma-separated sector slugs. Use all_no_forest to exclude forestry-and-land-use.

subsectorsstring nullable

Comma-separated subsector slugs.

Comma-separated subsector slugs.

gadm_idstring nullable

GADM administrative area identifier restricting results to that area.

GADM administrative area identifier restricting results to that area.

city_idstring nullable

GHS Functional Urban Area identifier (e.g. ghs-fua_2702).

GHS Functional Urban Area identifier (e.g. ghs-fua_2702).

country_groupstring nullable

Named country group slug (e.g. g7, g20, eu).

Named country group slug (e.g. g7, g20, eu).

continentstring nullable

Continent name restricting the result set.

Continent name restricting the result set.

owner_idsstring nullable

Comma-separated owner identifiers (e.g. E100000001213) from /owners to restrict to company-owned sources.

Comma-separated owner identifiers (e.g. E100000001213) from /owners to restrict to company-owned sources.

limitinteger

Maximum rows per page (1 to 1000).

Maximum rows per page (1 to 1000).

offsetinteger

Offset into the ranked result set.

Offset into the ranked result set.

Response

Ranked asset-level source rows with centroid, activity, capacity, and emissions totals.

Example response

{
  "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"
    ]
  }
}