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

# Search Energy Owners

`GET /api/v2/energy/owners`

Search the Global Energy Monitor ownership registry for canonical owner entities. Use this endpoint to resolve a company, government owner, person, or investment vehicle to a GEM Entity ID before calling owner portfolio or exposure endpoints.

## Query parameters

- `q` string
- `search` string
- `entity_id` string
- `country` string
- `region` string
- `continent` string
- `entity_type` string
- `publicly_listed` boolean
- `limit` integer
- `cursor` string

## Response `200`

Success

- EnergyOwnersListResponse
  - `success` true, required
  - `data` EnergyOwnerCard[], required
    - `entity_id` string, required
    - `full_name` string, required
    - `name` string, required
    - `name_local` string, nullable
    - `name_other` string, nullable
    - `abbreviation` string, nullable
    - `entity_type` string, required
    - `legal_entity_type` string, required
    - `publicly_listed` boolean, nullable
    - `home_page` string, nullable
    - `registration_country` string
    - `registration_country_iso3` string
    - `registration_subdivision` string, nullable
    - `headquarters_country` string
    - `headquarters_country_iso3` string
    - `headquarters_subdivision` string, nullable
    - `gem_parents` string[], required
    - `gem_parent_ids` string[], required
    - `external_ids` object, required
    - `dataset_version` string, required
    - `source_file` string, required
    - `ingested_at` string
    - `portfolio_url` string, nullable
    - `detail_url` string, nullable
    - `portfolio_summary` EnergyOwnerPortfolioSummary
      - `asset_count` number, required
      - `capacity_mw_total` number, required
      - `by_tracker` EnergyOwnerPortfolioTracker[], required
        - `tracker` string, required
        - `asset_count` number, required
        - `capacity_mw_total` number, required
        - `operating_count` number, required
        - `planned_count` number, required
        - `inactive_count` number, required
    - `exposure_summary` EnergyOwnerExposureSummary[]
      - `lens` 'sanctions' | 'china' | 'state_owned', required
      - `exposed` boolean, required
      - `direct` boolean, required
      - `via_entity_ids` string[], required
      - `lists` string[], required
      - `china_edges` string[], required
  - `pagination` EnergyPagination, required
    - `limit` integer, required
    - `cursor` string, nullable, required
    - `next_cursor` string, nullable, required
  - `applied_filters` object

## Other responses

- `401` — API key required. Include: Authorization: Bearer gdelt_sk_...
- `500` — Failed to fetch energy owners.

---

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