---
title: "Ownership-chain exposure"
method: GET
path: "/api/v2/exposure"
tags: ["Screening and Reference"]
---

# Ownership-chain exposure

`GET /api/v2/exposure`

Precomputed ownership-chain exposure across three lenses (sanctions / china / state_owned) over energy assets (risk-per-MW) or entities, with contributing lists and ownership paths. Requires a plan with Ownership-chain exposure access (`can_use_exposure`) — the Corporate & Supply Chain plan and above.

## Query parameters

- `lens` 'sanctions' | 'china' | 'state_owned'
- `subject` 'assets' | 'entities'
- `country` string
- `tracker` string
- `source` string
- `entity_id` string
- `entity` string
- `counterparty` string
- `min_stake_pct` number
- `direct_only` boolean
- `group_by` 'none' | 'country' | 'tracker'
- `sort` 'capacity_desc' | 'stake_desc'
- `limit` integer
- `cursor` string

## Response `200`

Ownership-chain exposure.

- object
  - `success` boolean
  - `lens` string
  - `subject` string
  - `data` object[]
    - `gem_id` string
    - `tracker` string
    - `country_iso3` string
    - `capacity_mw` integer
    - `exposed` boolean
    - `direct` boolean
    - `max_chain_depth` integer
    - `exposure_stake_pct` integer
    - `contributing_entity_ids` string[]
    - `contributing_lists` string[]
    - `paths` object[]
      - `entity_id` string
      - `via` string[]
      - `stake_pct` integer
      - `list_hits` string[]
  - `pagination` object
    - `limit` integer
    - `cursor` unknown
    - `next_cursor` unknown
  - `sort` string
  - `resolved_counterparties` unknown[]
    - unknown
  - `timings_ms` object
    - `counterparty_search` integer
  - `applied_filters` object
    - `lens` string
    - `subject` string
    - `country` string[]

## Other responses

- `401` — Missing/invalid API key
- `403` — Plan required (PLAN_REQUIRED) — the caller's plan does not carry the required source entitlement.
- `500` — Server error

---

[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/versions/01aaa6255180/schema)