# GLEIF Level 2 Relationship Data (Who Owns Whom) Model
> Model corporate family trees, ultimate beneficial owners, and direct/ultimate accounting consolidation parents using GLEIF Level 2 data.

- **Canonical URL:** https://stanzaapi.com/tools/lei-validator/gleif/gleif-level-2-relationship-data
- **Governing Standard:** ISO 17442 Legal Entity Identifier (Global Legal Entity Identifier Foundation (GLEIF))
- **Latency:** <1ms Edge
- **Privacy:** In-memory execution only (zero data stored or logged)

## Technical Overview & Governing Rules
GLEIF Level 2 records provide transparency into corporate ownership structures by answering "who owns whom" through Direct and Ultimate Accounting Consolidation Parents.

## Specification Matrix
| Relationship Type | Definition | Accounting Threshold |
| --- | --- | --- |
| Direct Parent | Entity that prepares consolidated financial statements including the child | Typically >50% voting control |
| Ultimate Parent | Highest consolidation parent in the corporate hierarchy | Highest level parent |

## Standard JSON Response Model
```json
{
  "childLei": "5493006MHB84DD0ZWV18",
  "directParentLei": "5493000P9J24H2T76A28",
  "ultimateParentLei": "5493000P9J24H2T76A28"
}
```

## Frequently Asked Questions & Edge Cases
### Q: What happens if an entity has no parent company?
**A:** The LEI record specifies an official opt-out reason code (e.g. NATURAL_PERSONS, NO_KNOWN_PERSON, NON_CONSOLIDATING).
