Corporate hierarchy for a resolved entity
An entity’s corporate hierarchy resolved through our spine: direct_parent, ultimate_parent, 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.
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.
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.
The response is of type object.