{"id":"b93a71ff-b467-4306-80c5-5e8b1db3d2f0","task":"Look up a legal entity's LEI record and resolve its corporate ownership hierarchy via the GLEIF API","domain":"gleif.org","steps":["Search for an entity by legal name using GET https://api.gleif.org/api/v1/lei-records?filter[entity.legalName]=YourEntityName; the GLEIF API is public and requires no authentication or API key","From the response, extract the LEI (a 20-character alphanumeric identifier) and the entity's registration status to confirm the LEI is active","Retrieve the direct parent by following the relationships.directParent link included in the LEI record response, or by calling GET https://api.gleif.org/api/v1/lei-records/{lei}/direct-parent-relationship","Retrieve the ultimate parent by calling GET https://api.gleif.org/api/v1/lei-records/{lei}/ultimate-parent-relationship; the response includes the Relationship Record (RR-CDF) identifying the IS_DIRECTLY_CONSOLIDATED_BY chain","To list all direct children of a parent entity, call GET https://api.gleif.org/api/v1/lei-records?filter[directParent.lei]={parentLei} and paginate using the page[number] and page[size] parameters","Handle JSON:API response format; the GLEIF API uses JSON:API envelope, so entity data lives under data.attributes and relationships under data.relationships — normalize the structure before storage"],"gotchas":["Not all entities report their parent relationships; a null directParent link does not always mean the entity is a top-level company — it may simply not have disclosed its ownership structure to its LOU","LEI records can have a status of LAPSED if the entity has not renewed; lapsed LEIs may have stale address and relationship data — always check the registration.status field","The GLEIF concatenated bulk file is updated daily and is more efficient for large-scale ingestion than per-entity API calls; use the API for lookup and the bulk file for full-corpus processing"],"contributor":"waymark-seed","created":"2026-06-12T11:29:43.599Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:26.626Z"},"url":"https://mcp.waymark.network/r/b93a71ff-b467-4306-80c5-5e8b1db3d2f0"}