{"uid":"cap_SdMcphbAMCioyLuC4g3Gq","slug":"gleif-lei-ownership-graph-lookup-ca7044fe","name":"GLEIF LEI Ownership Graph Lookup","description":"Who owns whom, from the official GLEIF LEI graph (CC0 licensed, covers 2.5M+ legal entities worldwide). Query: ?lei=5493001KJTIIGC8Y1R12. Four GLEIF lookups in one call: entity name and status, declared direct parent, ultimate parent, plus the total count and a 10-entity sample of direct children. Unknown LEI returns found=false. 24h cache.","url":"https://data.greeneris.io/v1/lei/ownership","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["lei"],"properties":{"lei":{"type":"string","description":"20-character Legal Entity Identifier (ISO 17442)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"lei":"549300B56MD0ZC402L06","name":"Bloomberg L.P.","found":true,"source":"GLEIF (CC0)","status":"ACTIVE","direct_parent":{"lei":"549300RMUDWPHCUQNE66","name":"Bloomberg Inc."},"children_total":27,"children_sample":[{"lei":"254900PNPB5L5VNJNS35","name":"BLOOMBERG BETA 2016 L.P."},{"lei":"254900JY1M565T6QM850","name":"Bloomberg Finance Singapore L.P."}],"ultimate_parent":{"lei":"549300RMUDWPHCUQNE66","name":"Bloomberg Inc."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jBQQoxRwIJjAL97VTdGMi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves corporate ownership structure for a legal entity by LEI — including entity name/status, direct parent, ultimate parent, and direct children — from the official GLEIF registry.","exampleAgentPrompt":"Can you look up the full ownership structure for the legal entity with LEI 5493001KJTIIGC8Y1R12 — I need to know its name and status, who its direct and ultimate parent are, and how many direct children it has?","exampleUseCases":[{"title":"KYC counterparty ownership check","prompt":"I'm onboarding a new counterparty and their LEI is 549300TRUWO2CD2G5692 — can you pull their GLEIF ownership record so I can see who their ultimate parent is and whether the entity is active?"},{"title":"Subsidiary mapping for M&A research","prompt":"We're researching the corporate structure of a target company whose LEI is 5299000J2N45DDNE4Y28 — can you tell me how many direct children it has and give me a sample list of them from GLEIF?"},{"title":"Regulatory filing entity validation","prompt":"Before we submit this regulatory report, can you verify that LEI 2138003W0CRBRME20574 is currently active in GLEIF and confirm its declared direct parent?"}],"resultDescription":"A JSON object indicating whether the LEI was found (found: true/false), along with the entity's name and registration status, its declared direct parent LEI and name, its ultimate parent LEI and name, and the total count plus a 10-entity sample of its direct children. Data is sourced from the GLEIF LEI graph (CC0 licensed) and cached for 24 hours.","failureModes":["Unknown or invalid LEI returns found=false with no ownership data","Malformed LEI (not 20 characters or wrong format) may return a validation error","Entities with no declared parent return null parent fields","Cached data may be up to 24 hours stale relative to GLEIF updates","Payment failure (x402) returns 402 if USDC payment is not provided"],"whenToPreferThis":"Use this endpoint when you need a single-call view of a legal entity's full ownership hierarchy — direct parent, ultimate parent, and children — from the authoritative GLEIF registry. Prefer this over scraping GLEIF directly or calling multiple GLEIF APIs, as it aggregates four lookups into one call with a 24-hour cache. Ideal for KYC, AML, counterparty due diligence, or regulatory research workflows where LEI-based ownership tracing is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:03:20.646Z","isFirstParty":false}