Sign in

v1

latestOpenAPI 3.0.32026-07-226744340.8 KB
Energy

Search Energy Assets

Search Global Energy Monitor energy-infrastructure assets across all 15 trackers. Returns clean asset cards with native capacity, MW capacity where meaningful, normalized geography, ownership arrays, GEM Wiki URLs, and detail/API links.

get/api/v2/energy/assets

Query parameters

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.

searchstring
Example:Ranch Energy

Case-insensitive substring match against asset name.

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

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

sort'capacity_desc' | 'capacity_asc' | 'start_year_desc' | 'start_year_asc' | 'recent' | 'name'

List sort order.

limitinteger

Number of asset cards to return.

cursorstring
Example:25

Pagination cursor from pagination.next_cursor.

Response

Success

successtrue required
sortstring required
applied_filtersobject