v1
latestOpenAPI 3.0.32026-07-226744340.8 KBOwnership-chain 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
sanctions | china | state_owned.
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.
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.
Energy-asset tracker (assets subject). All trackers: Taxonomy & Codes — Energy.
Restrict to a contributing list source_key.
Filter to one entity_id.
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.
Resolve a counterparty by name and filter to it.
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.
Only direct (non-via-parent) exposure.
assets grouping: none | country | tracker.
capacity_desc | stake_desc.
Rows per page.
Pagination cursor (opaque offset).
Response
Ownership-chain exposure.