# entities_get_ownership Traverse current GLEIF Level-2 consolidation relationships. | Field | Value | | --- | --- | | Category | Legal Entities (`entities`) | | Exposure | public | | MCP tool | `entities_get_ownership` | | Documentation | https://www.agentdatasets.com/docs/tools/entities_get_ownership | ## 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. | Parameter | In | Type | Required | Default | Constraints | Description | | --- | --- | --- | --- | --- | --- | --- | | lei | input | `string` | yes | — | — | Exact uppercase 20-character LEI from entities_search, entities_get, or a LEI-bearing funds/CMBS record. | | direction | input | `"parents" \| "children"` | no | "parents" | — | parents follows child-to-parent consolidation edges; children follows parent-to-child edges. | | depth | input | `integer` | no | 1 | min 1, max 2 | Breadth-first relationship hops to traverse (1-2). | | limit | input | `integer` | no | 50 | min 1, max 100 | Active Level-2 links per page (1-100). | | cursor | input | `string \| null` | no | null | — | Opaque cursor from pagination.next_cursor. Keep LEI, direction, and depth unchanged while paging; omit for the first page. | ## Provenance - `gleif` — Global Legal Entity Identifier Foundation, GLEIF golden copy Level-1 legal-entity identifiers, names, jurisdiction, status, registration authority, and address regions (Creative Commons CC0 1.0 Universal (cc0-1.0)). See https://www.agentdatasets.com/docs/attribution.md Dataset registry: `entities_gleif_level_two`.