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

# Map Energy Assets

`GET /api/v2/energy/assets/map`

Return map-ready Energy asset data. Without a single explicit country filter, the endpoint returns aggregate country-centroid rows. With exactly one country filter and no region or continent, it returns fine-grained asset pins capped by map_limit/fine_grained_limit.

## 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'
- `map_limit` integer
- `fine_grained_limit` integer

## Response `200`

Success

- EnergyAssetsMapResponse
  - `success` true, required
  - `mode` 'aggregate' | 'fine', required
  - `data` union[], required
    - union
      - EnergyMapAggregatePoint
        - `kind` 'aggregate', required
        - `country_iso3` string, required
        - `country` string, required
        - `lat` number, required
        - `lon` number, required
        - `asset_count` number, required
        - `capacity_mw_total` number, required
        - `top_tracker` string, required
        - `trackers` string[], required
      - EnergyMapFinePoint
        - `kind` 'fine', required
        - `gem_id` string, required
        - `tracker` string, required
        - `name` string, required
        - `country_iso3` string, required
        - `country` string, required
        - `lat` number, required
        - `lon` number, required
        - `status` string, required
        - `capacity_mw` number, nullable, required
        - `capacity_value` number, nullable, required
        - `capacity_unit` string, required
        - `fuel` string, required
  - `filters_echo` EnergyMapFiltersEcho, required
    - `tracker` string[], required
    - `country_iso3` string[], required
    - `status` string[], required
    - `tier` string[], required
    - `fuel` string[], required
    - `operating_only` boolean, required
    - `asset_class` 'fixed' | 'mobile' | 'all', required
  - `applied_filters` object

## Other responses

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

---

[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)