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

Exposure lens. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#exposure_lens

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

Result unit. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#exposure_subject

Available options:
assets,
entities
​
country
string

Country filter. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

​
region
enum<string>

Region expanded to countries. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

Available options:
Africa,
Asia,
Middle East,
Northern Africa,
Western Africa,
Eastern Africa,
Middle Africa,
Southern Africa,
Europe,
Eastern Europe,
South Asia,
Southeast Asia,
East Asia,
Central Asia,
North America,
Central America,
Caribbean,
South America,
Oceania
​
continent
enum<string>

Continent expanded to countries. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

Available options:
Africa,
Asia,
Europe,
North America,
South America,
Oceania
​
tracker
string

GEM tracker filter. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

​
list
enum<string>

Contributing restricted-party list. source is an alias. Also accepts: source. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#exposure_list

Available options:
csl_ofac_sdn,
csl_ofac_ssi,
csl_ofac_cmic,
csl_ofac_nsmbs,
csl_ofac_capta,
csl_bis_entity,
csl_bis_meu,
csl_bis_uvl,
csl_bis_dpl,
csl_state_debarred,
csl_state_isn,
dod_1260h,
un_consolidated,
uk_uksl,
state_owned,
cn_state
​
min_stake_pct
number

Minimum effective ownership-chain stake. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

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

Restrict to direct exposure. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

​
entity
string

Resolved entity identifier. entity_id is an alias. Also accepts: entity_id. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

​
entity_search
string

Fuzzy entity resolver query. q and counterparty are aliases. Also accepts: q, counterparty. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

​
gem_id
string

GEM asset identifier. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

​
group_by
enum<string>
default:none

Aggregation dimension. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#exposure_group_by

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

Result ordering. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#exposure_sort

Available options:
capacity_desc,
stake_desc
​
limit
integer
default:25

Maximum rows returned. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

Required range: 1 <= x <= 100
​
cursor
string

Pagination cursor. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

​
offset
integer

Legacy numeric offset. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

Required range: x >= 0

Response

Ownership-chain exposure.

​
success
boolean
required
​
lens
enum<string>
required
Available options:
sanctions,
china,
state_owned
​
subject
enum<string>
required
Available options:
assets,
entities
​
data
object[]
required
​
resolved_counterparties
object[]
required
​
timings_ms
object
required
​
applied_filters
any
required
​
subject_note
string
​
group_by
string
​
pagination
any
​
sort
string