curl --request GET \
--url https://gdeltcloud.com/api/v2/entities/{entity_id}/hierarchy \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/entities/{entity_id}/hierarchy"
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/entities/{entity_id}/hierarchy', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"entity": {
"entity_id": "e_7f03c3a1",
"lei": null
},
"hierarchy": null,
"coverage": {
"lei_present": false,
"in_gleif_level2": null,
"reporting_exception": null,
"note": "This entity carries no LEI in our crosswalk, so GLEIF hierarchy is unavailable. This is a coverage gap, not evidence of no parent."
},
"meta": {
"source": "ref.gleif_relationships",
"time_semantics": "Current relationship snapshot."
}
}Corporate hierarchy for a resolved entity
An entity’s corporate hierarchy resolved through our spine: direct_parent, ultimate_parent, parent_assertions, parent_chain, children and child_count. Accepts the same identifiers as the rest of the API — a name, an e_ id, a wiki: id or a wikipedia_url — and additionally a bare 20-character LEI, so the identifier you searched with works at this hop too.
Read the coverage block before the hierarchy. lei_present: false means the entity carries no LEI in our crosswalk — a coverage gap, NOT evidence the entity has no parent. reporting_exception carries the reason a filer gave for not naming a parent (for example NO_KNOWN_PERSON), which is a DECLARED absence and materially different from an unknown one. child_count is null, never 0, when the requested direction excluded children.
Corporate hierarchy as reported to the Global LEI System: accounting consolidation under IFRS/US-GAAP, not percentage ownership and not beneficial ownership. Natural persons are out of scope, and reporting is partial — an absent parent usually means the filer declared a reporting exception rather than that none exists.
Gated on the existing can_use_exposure entitlement; the LEI itself is ungated. Point-in-time (as_of) is not supported for this source.
direct_parent is populated only when the active direct-accounting-parent assertions name one unique LEI; ultimate-only or international-branch records never become a direct parent. ultimate_parent likewise requires one unique ultimate-accounting-parent LEI. Conflicts remain visible in optional parent_assertions, including source references and dates. A null parent is not proof that no parent exists. The upward parent_chain follows only unique direct accounting edges; it never invents intermediate edges from an ultimate-parent assertion. Optional parent_chain_status and parent_chain_stop_lei disclose unrequested walks, missing direct assertions, depth limits, conflicting direct parents and cycles. These are current recorded assertions, not percentage ownership or a complete corporate graph.
curl --request GET \
--url https://gdeltcloud.com/api/v2/entities/{entity_id}/hierarchy \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/entities/{entity_id}/hierarchy"
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/entities/{entity_id}/hierarchy', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"entity": {
"entity_id": "e_7f03c3a1",
"lei": null
},
"hierarchy": null,
"coverage": {
"lei_present": false,
"in_gleif_level2": null,
"reporting_exception": null,
"note": "This entity carries no LEI in our crosswalk, so GLEIF hierarchy is unavailable. This is a coverage gap, not evidence of no parent."
},
"meta": {
"source": "ref.gleif_relationships",
"time_semantics": "Current relationship snapshot."
}
}Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Path Parameters
A name, an e_ spine id, a wiki: news id, a wikipedia_url, or a bare 20-character LEI.
Query Parameters
Which way to walk. Full value list: https://docs.gdeltcloud.com/reference/enums#entity_hierarchy_direction
up, down, both Ancestor chain depth.
1 <= x <= 5Include entities sharing the same direct parent.
Children to return.
1 <= x <= 50Response
entity, hierarchy (or null), coverage and meta — the latter carrying the GLEIF attribution, the consolidation disclaimer verbatim, and time_semantics. Optional hierarchy assertion and walk-status fields preserve evidence without selecting a conflicting parent or treating an ultimate/branch assertion as a direct accounting edge.
Show child attributes
Show child attributes
Null when the resolved entity has no LEI crosswalk. Read coverage before interpreting absence.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
GLEIF source, license, attribution, consolidation disclaimer and time semantics.