Rank asset-level emission sources by emissions

GET

/api/v1/environment/ct/sources

Last modified:2026-05-10 09:22:39

Maintainer:Not configured

OperationId:environment_ct_sources

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.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/environment/ct/sources?year=2023&gas=co2e_100yr&sectors=power&subsectors=electricity-generation&gadm_id=USA.5_1&city_id=ghs-fua_2702&country_group=g7&continent=Asia&owner_ids=E100000001213&limit=25&offset=0' \
--header 'x-api-key: <api-key>'

Responses

🟢200

application/json

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

Bodyapplication/json

Example

{
    "data": {
        "sources": [
            {
                "id": 0,
                "name": "string",
                "sector": "string",
                "subsector": "string",
                "country": "string",
                "adminId": "string",
                "cityId": "string",
                "assetType": "string",
                "sourceType": "string",
                "centroid": {
                    "longitude": 0,
                    "latitude": 0,
                    "srid": 0
                },
                "gas": "string",
                "emissionsQuantity": 0,
                "emissionsFactor": 0,
                "emissionsFactorUnits": "string",
                "activity": 0,
                "activityUnits": "string",
                "capacity": 0,
                "capacityUnits": "string",
                "capacityFactor": 0,
                "year": 0
            }
        ],
        "limit": 0,
        "offset": 0
    },
    "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": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true
    }
}

🟠401

🟠422

🟠429

🔴503

Modified at 2026-05-10 09:22:39

Rank countries by greenhouse-gas emissions for a gas and window

Aggregated emissions broken down by sector, subsector, and gas