Sign in

v1

latestOpenAPI 3.0.32026-07-226744340.8 KB
Energy

Summarize Energy Assets

Aggregate counts and MW rollups across Energy assets. Summary endpoints use structured filters only. capacity_mw fields are meaningful for power-generation trackers; constrain tracker when comparing capacity across unit families.

get/api/v2/energy/assets/summary

Query parameters

group_by'country' | 'region' | 'continent' | 'tracker' | 'status' | 'start_year_decade' | 'fuel' | 'tier'

Summary aggregation dimension.

trackerstring
Example:coal_plants,solar

Comma-separated GEM trackers. Valid values: coal_plants, coal_mines, coal_terminals, oil_gas_plants, oil_gas_extraction, lng_terminals, nuclear, geothermal, bioenergy, hydropower, solar, wind, gas_pipelines, oil_pipelines, lng_carriers. Omit for all trackers. All trackers: Taxonomy & Codes — Energy.

countrystring
Example:United States

Country filter, resolved through the shared resolveCountryInput layer: a country name (United States), ISO-2 (US), ISO-3 (USA), or legacy alias all work. Filters primary or secondary country for cross-border assets; combinable with region/continent and an unresolvable value returns 400 INVALID_COUNTRY.

region'Africa' | 'Asia' | 'Middle East' | 'Northern Africa' | 'Western Africa' | 'Eastern Africa' | 'Middle Africa' | 'Southern Africa' | 'Europe' | 'Eastern Europe' | 'South Asia' | 'Southeast Asia' | 'East Asia' | 'Central Asia' | 'North America' | 'Central America' | 'Caribbean' | 'South America' | 'Oceania'
Example:Middle East

Plain English region. Expands to the same ISO-3 country list used by V2 Events.

continent'Africa' | 'Asia' | 'Europe' | 'North America' | 'South America' | 'Oceania'
Example:Asia

Plain English continent. Expands to the same ISO-3 country list used by V2 Events.

statusstring
Example:operating,construction

Comma-separated GEM status values. Common values include operating, construction, pre-construction, permitted, announced, proposed, shelved, cancelled, retired, and mothballed. See Taxonomy & Codes — Energy.

operating_onlyboolean

Shorthand for status=operating.

tierstring
Example:main,utility

Comma-separated within-tracker tier values such as main, utility, distributed, below_threshold, closed, or sub_threshold.

fuelstring
Example:coal,solar

Comma-separated fuel values. Matches the tracker-native fuel string or normalized cross-tracker fuel where populated. See Taxonomy & Codes — Energy.

capacity_mw_minnumber

Minimum MW capacity. Meaningful for power-generation trackers only.

capacity_mw_maxnumber

Maximum MW capacity. Meaningful for power-generation trackers only.

start_year_mininteger

Minimum asset start year.

start_year_maxinteger

Maximum asset start year.

retired_year_mininteger

Minimum asset retired year.

retired_year_maxinteger

Maximum asset retired year.

entitystring
Example:ArcelorMittal

Canonical owner selector — the same entity value works across endpoints. Pass a spine entity id (e_...) for an EXACT match against an asset's owners, operators, or parents, or any name for a case-insensitive fuzzy owner-name match. Preferred over the legacy owner_search param.

owner_searchstring
Example:ExxonMobil

Legacy — prefer the canonical entity param (still fully supported). Case-insensitive substring match against the raw owner string.

owner_entity_idstring
Example:E100002021305

GEM Entity ID. Returns assets where the entity appears in owners, operators, or parents.

bboxstring
Example:30,-105,33,-100

Viewport filter formatted as lat_min,lon_min,lat_max,lon_max.

nearstring
Example:31.16,-102.9,50

Proximity filter formatted as lat,lon,radius_km.

asset_class'fixed' | 'mobile' | 'all'

Asset class. The default fixed excludes mobile LNG carriers; use mobile or all for vessels.

summary_limitinteger

Number of summary buckets to return.

Response

Success

successtrue required
group_by'country' | 'region' | 'continent' | 'tracker' | 'status' | 'start_year_decade' | 'fuel' | 'tier' required
applied_filtersobject