Skip to main content
GET
Ownership-chain exposure

Authorizations

Authorization
string
header
required

GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....

Query Parameters

lens
enum<string>
default:sanctions

sanctions | china | state_owned.

Available options:
sanctions,
china,
state_owned
subject
enum<string>
default:assets

Exposure subject: assets (risk-per-MW over energy assets, the default) or entities. Auto-selects entities when you pass an entity handle (entity_id, entity, entity_search, counterparty, or q) without an explicit subject and without an asset selector (gem_id/tracker) — so ?entity_id=e_... just works. Pass subject=assets explicitly to force the asset lens; the response surfaces a subject_note when it auto-switches.

Available options:
assets,
entities
country
string

Country filter(s), comma-separated. Accepts a country name (Indonesia), ISO-2 (ID), or ISO-3 (IDN) via the shared resolveCountryInput layer (combinable with region/continent); an unresolvable value returns 400 INVALID_COUNTRY.

Example:

"Indonesia"

tracker
string

Energy-asset tracker (assets subject). All trackers: Taxonomy & Codes — Energy.

source
string

Restrict to a contributing list source_key.

entity_id
string

Filter to one entity_id.

entity
string

Alias of entity_id. Must be a RESOLVED entity id (e_…, wiki:…, or llm:…) — a bare name returns 400 INVALID_ENTITY_ID telling you to resolve it via /api/v2/search (or use counterparty for a fuzzy name match). On subject=assets it filters assets whose contributing owners include the id; on subject=entities it selects that entity's own exposure row.

counterparty
string

Resolve a counterparty by name and filter to it.

min_stake_pct
number

Minimum ownership stake, in percent (0–100), for an asset row to be returned (exposure_stake_pct >= min_stake_pct). Applies to subject=assets only; out-of-range or non-numeric values return 400 INVALID_NUMBER.

Required range: 0 <= x <= 100
direct_only
boolean

Only direct (non-via-parent) exposure.

group_by
enum<string>

assets grouping: none | country | tracker.

Available options:
none,
country,
tracker
sort
enum<string>

capacity_desc | stake_desc.

Available options:
capacity_desc,
stake_desc
limit
integer
default:25

Rows per page.

cursor
string

Pagination cursor (opaque offset).

Response

Ownership-chain exposure.

success
boolean
lens
string
subject
string
data
object[]
pagination
object
sort
string
resolved_counterparties
any[]
timings_ms
object
applied_filters
object