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

# Summarize Energy Assets

`GET /api/v2/energy/assets/summary`

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.

## Query parameters

- `group_by` 'country' | 'region' | 'continent' | 'tracker' | 'status' | 'start_year_decade' | 'fuel' | 'tier'
- `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
- `asset_class` 'fixed' | 'mobile' | 'all'
- `summary_limit` integer

## Response `200`

Success

- EnergyAssetsSummaryResponse
  - `success` true, required
  - `group_by` 'country' | 'region' | 'continent' | 'tracker' | 'status' | 'start_year_decade' | 'fuel' | 'tier', required
  - `data` EnergyAssetSummaryBucket[], required
    - `bucket` string, nullable, required
    - `bucket_kind` string, required
    - `asset_count` number, required
    - `capacity_mw_total` number, required
    - `capacity_mw_avg` number, nullable, required
    - `capacity_mw_max` number, nullable, required
    - `capacity_mw_min` number, nullable, required
    - `status_counts` object, required
      - `operating` number, required
      - `construction` number, required
      - `proposed` number, required
      - `cancelled` number, required
      - `retired` number, required
  - `applied_filters` object

## Other responses

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

---

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