entities_get_ownership
Traverse current GLEIF Level-2 consolidation relationships.
Description
Traverse current GLEIF Level-2 consolidation relationships.
The shared envelope echoes the root LEI, direction, and depth. It returns
a breadth-first data.links page with direct and ultimate consolidation
edges plus data.exceptions for page-relevant entities where GLEIF
reported why no parent exists. Each evidence row includes source,
license, validation fields, and as_of. Depth is 1-2, limit is 1-100,
and pagination.next_cursor continues a page. Use parents to identify a
corporate-family chain and children to enumerate consolidated entities.
Example: lei="YYPPRNO5HB304LHFVG31", direction="parents", depth=2.
bad_parameter reports malformed input or cursor; unknown_entity
means no held Level-1 or Level-2 evidence exists. GLEIF data is CC0.
Parameters
Input schema advertised to MCP clients and mirrored by the REST query string.
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| lei | string | Yes | — | — | Exact uppercase 20-character LEI from entities_search, entities_get, or a LEI-bearing funds/CMBS record. |
| direction | "parents" | "children" | No | "parents" | — | parents follows child-to-parent consolidation edges; children follows parent-to-child edges. |
| depth | integer | No | 1 | min 1, max 2 | Breadth-first relationship hops to traverse (1-2). |
| limit | integer | No | 50 | min 1, max 100 | Active Level-2 links per page (1-100). |
| cursor | string | null | No | null | — | Opaque cursor from pagination.next_cursor. Keep LEI, direction, and depth unchanged while paging; omit for the first page. |
Provenance
Sources behind every value this tool returns.
- gleifGlobal Legal Entity Identifier Foundation
Dataset registry: entities_gleif_level_two