---
title: "Get Energy Owner"
method: GET
path: "/api/v2/energy/owners/{entity_id}"
tags: ["Energy"]
---

# Get Energy Owner

`GET /api/v2/energy/owners/{entity_id}`

Fetch one Global Energy Monitor ownership entity by GEM Entity ID, including parent IDs, external IDs, and a portfolio summary across Energy assets. Optional include_exposure=true adds plan-gated risk/exposure fields — requires `can_use_exposure` (the Corporate & Supply Chain plan and above).

## Path parameters

- `entity_id` string, required

## Query parameters

- `include_exposure` boolean

## Response `200`

Success

- EnergyOwnerDetailResponse
  - `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

## Other responses

- `401` — API key required. Include: Authorization: Bearer gdelt_sk_...
- `403` — Plan required (PLAN_REQUIRED) — `include_exposure=true` needs the `can_use_exposure` entitlement.
- `404` — Owner not found.
- `500` — Failed to fetch energy owner.

---

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