---
title: "Search Energy Assets"
method: GET
path: "/api/v2/energy/assets"
tags: ["Energy"]
---

# Search Energy Assets

`GET /api/v2/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.

## Query parameters

- `tracker` string
- `country` string
- `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'
- `continent` 'Africa' | 'Asia' | 'Europe' | 'North America' | 'South America' | 'Oceania'
- `status` string
- `operating_only` boolean
- `tier` string
- `fuel` string
- `capacity_mw_min` number
- `capacity_mw_max` number
- `start_year_min` integer
- `start_year_max` integer
- `retired_year_min` integer
- `retired_year_max` integer
- `entity` string
- `owner_search` string
- `owner_entity_id` string
- `bbox` string
- `near` string
- `search` string
- `asset_class` 'fixed' | 'mobile' | 'all'
- `sort` 'capacity_desc' | 'capacity_asc' | 'start_year_desc' | 'start_year_asc' | 'recent' | 'name'
- `limit` integer
- `cursor` string

## Response `200`

Success

- EnergyAssetsListResponse
  - `success` true, required
  - `data` EnergyAssetCard[], required
    - `id` string, required
    - `gem_id` string, required
    - `tracker` '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', required
    - `tier` string, nullable, required
    - `asset_class` string, required
    - `name` string, required
    - `name_local` string, nullable, required
    - `name_other` string, nullable, required
    - `status` string, required
    - `status_detail` string, nullable, required
    - `start_year` integer, nullable, required
    - `retired_year` integer, nullable, required
    - `fuel` string, nullable, required
    - `capacity` EnergyCapacity, required
      - `value` number, nullable, required
      - `unit` string, required
      - `mw` number, nullable, required — Populated only for power-generation trackers.
      - `mw_secondary` number, nullable, required
    - `geo` EnergyAssetGeo, required
      - `country` string, nullable, required
      - `country_iso3` string, nullable, required
      - `secondary_country_iso3` string, nullable, required
      - `region` string, nullable, required
      - `subregion` string, nullable, required
      - `continent` string, nullable, required
      - `state_province` string, nullable, required
      - `city` string, nullable, required
      - `lat` number, nullable, required
      - `lon` number, nullable, required
      - `location_accuracy` string, nullable, required
    - `owners_raw` string, nullable, required
    - `owners` EnergyOwnerEntry[], required
      - `name` string, required
      - `entity_id` string, nullable, required
      - `stake_pct` number, nullable, required
    - `operators_raw` string, nullable, required
    - `operators` EnergyOwnerEntry[], required
      - `name` string, required
      - `entity_id` string, nullable, required
      - `stake_pct` number, nullable, required
    - `parents_raw` string, nullable, required
    - `parents` EnergyOwnerEntry[], required
      - `name` string, required
      - `entity_id` string, nullable, required
      - `stake_pct` number, nullable, required
    - `wiki_url` string, nullable, required
    - `last_updated` string, nullable, required
    - `detail_url` string, required
    - `api_url` string, required
  - `pagination` EnergyPagination, required
    - `limit` integer, required
    - `cursor` string, nullable, required
    - `next_cursor` string, nullable, required
  - `sort` string, required
  - `filters_echo` EnergyListFiltersEcho, required
    - `tracker` string[], required
    - `country_iso3` string[], required
    - `status` string[], required
    - `tier` string[], required
    - `fuel` string[], required
    - `capacity_mw_min` number, nullable, required
    - `capacity_mw_max` number, nullable, required
    - `start_year_min` number, nullable, required
    - `start_year_max` number, nullable, required
    - `owner_search` string, nullable, required
    - `owner_entity_id` string, nullable, required
    - `bbox` object, nullable, required
      - `latMin` number, required
      - `lonMin` number, required
      - `latMax` number, required
      - `lonMax` number, required
    - `near` object, nullable, required
      - `lat` number, required
      - `lon` number, required
      - `radiusKm` number, required
    - `search` string, nullable, required
    - `operating_only` boolean, required
    - `asset_class` 'fixed' | 'mobile' | 'all', required
  - `applied_filters` object

## Other responses

- `400` — Invalid Energy filter.
- `401` — API key required. Include: Authorization: Bearer gdelt_sk_...
- `429` — Rate limit or quota exceeded.
- `500` — Failed to fetch energy assets.

---

[API](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2.md) · [All operations](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gdeltcloud/gdelt-cloud-api-v2/revisions/01aaa6255180/schema)