Environment

Rank asset-level emission sources by emissions

Changed on

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

Request

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

Query parameters

yearinteger

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

gasstring

Gas identifier from /definitions/gases.

sectorsstring nullable

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

subsectorsstring nullable

Comma-separated subsector slugs.

gadm_idstring nullable

GADM administrative area identifier restricting results to that area.

city_idstring nullable

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

country_groupstring nullable

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

continentstring nullable

Continent name restricting the result set.

owner_idsstring nullable

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

limitinteger

Maximum rows per page (1 to 1000).

offsetinteger

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",
    "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