curl --request GET \
--url https://gdeltcloud.com/api/v2/exposure \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/exposure"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/exposure', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"lens": "sanctions",
"subject": "assets",
"data": [
{
"gem_id": "G100001070620",
"tracker": "GOGET",
"country_iso3": "RUS",
"capacity_mw": null,
"exposed": true,
"direct": false,
"max_chain_depth": 1,
"exposure_stake_pct": 10,
"effective_stake_pct": 10,
"stake_status": "known",
"contributing_entity_ids": [
"e_2bf6cdc5bc0d9097"
],
"contributing_lists": [
"state_owned"
],
"paths": [
{
"entity_id": "e_2bf6cdc5bc0d9097",
"via": "E100002004816",
"asset_owner_stake_pct": 100,
"chain_ownership_pct": 10,
"effective_stake_pct": 10,
"stake_status": "known",
"depth": 1,
"gem_path": [
"E100002004816",
"E100001014354"
]
}
]
}
],
"pagination": {
"limit": 25,
"cursor": null,
"next_cursor": null
},
"sort": "capacity_desc",
"resolved_counterparties": [],
"timings_ms": {
"counterparty_search": 0
},
"applied_filters": {
"lens": "sanctions",
"subject": "assets",
"entity_id": "e_2bf6cdc5bc0d9097"
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}Ownership-chain exposure
Precomputed entity and facility exposure through sanctions, China, or state-ownership chains. Numeric stake filters apply to effective chain stake, never the direct asset-owner percentage alone. A configured registry requires positive source publication; unavailable publication returns 503 SOURCE_UNAVAILABLE. Successful configured responses preserve the selected release and coverage in meta.
curl --request GET \
--url https://gdeltcloud.com/api/v2/exposure \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/exposure"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/exposure', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"lens": "sanctions",
"subject": "assets",
"data": [
{
"gem_id": "G100001070620",
"tracker": "GOGET",
"country_iso3": "RUS",
"capacity_mw": null,
"exposed": true,
"direct": false,
"max_chain_depth": 1,
"exposure_stake_pct": 10,
"effective_stake_pct": 10,
"stake_status": "known",
"contributing_entity_ids": [
"e_2bf6cdc5bc0d9097"
],
"contributing_lists": [
"state_owned"
],
"paths": [
{
"entity_id": "e_2bf6cdc5bc0d9097",
"via": "E100002004816",
"asset_owner_stake_pct": 100,
"chain_ownership_pct": 10,
"effective_stake_pct": 10,
"stake_status": "known",
"depth": 1,
"gem_path": [
"E100002004816",
"E100001014354"
]
}
]
}
],
"pagination": {
"limit": 25,
"cursor": null,
"next_cursor": null
},
"sort": "capacity_desc",
"resolved_counterparties": [],
"timings_ms": {
"counterparty_search": 0
},
"applied_filters": {
"lens": "sanctions",
"subject": "assets",
"entity_id": "e_2bf6cdc5bc0d9097"
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Query Parameters
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
sanctions, china, state_owned 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
assets, entities 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 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.
Middle East, Northern Africa, Western Africa, Eastern Africa, Middle Africa, Southern Africa, Eastern Europe, South Asia, Southeast Asia, East Asia, Central Asia, Northern America, Central America, Caribbean 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.
Africa, Asia, Europe, North America, South America, Oceania 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.
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
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 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.
0 <= x <= 100Restrict 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.
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.
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 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.
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
none, country, tracker 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
capacity_desc, stake_desc 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.
1 <= x <= 100Continuation from pagination.next_cursor in the previous response. Keep the other filters unchanged; null means no next page. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Legacy number of source-article rows to skip; prefer the continuation cursor for new calls. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
x >= 0Response
Ownership-chain exposure.
sanctions, china, state_owned assets, entities - Option 1
- Option 2
- Option 3
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Selected source release and positive publication evidence, when a registry release is configured.
Show child attributes
Show child attributes