{"uid":"cap_4OpZ8mVSelxXRIwMSsz6-","slug":"gleif-lei-corporate-ownership-hierarchy-lookup-115291c6","name":"GLEIF LEI Corporate Ownership Hierarchy Lookup","description":"Corporate ownership graph for a legal entity by LEI (GLEIF Level-2 relationships, live). Returns the direct parent and ultimate parent (each: LEI, legal name, jurisdiction, country, status), the direct children (paged), and total counts of direct and ultimate children. The authoritative 'who owns whom' lookup for KYB, beneficial-ownership, and corporate-tree mapping — complements business.lei (entity reference) and business.lei-isins.","url":"https://2s.io/api/business/lei-hierarchy","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["lei"],"properties":{"lei":{"type":"string","description":"20-character LEI, e.g. HWUPKR0MPOU8FGXBT394 (Apple Inc.)."},"childLimit":{"type":"integer","maximum":50,"minimum":1,"description":"Max direct children to return (1-50, default 10)."}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0036","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.0036/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0036","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0036","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_n4Gg1iquUGf4Dgu0yoKRG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0036","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the full corporate ownership tree for a legal entity by LEI, including direct parent, ultimate parent, direct children (paged), and total ownership counts using GLEIF Level-2 relationship data.","exampleAgentPrompt":"Can you pull up the full ownership hierarchy for Apple Inc. using their LEI HWUPKR0MPOU8FGXBT394 — I need to see both the direct parent and ultimate parent, plus up to 20 of their direct subsidiaries?","exampleUseCases":null,"resultDescription":"Returns a JSON object containing: (1) the direct parent entity with LEI, legal name, jurisdiction, country, and status; (2) the ultimate parent entity with the same fields; (3) a paged list of direct children entities (up to the requested childLimit); (4) total count of direct children; and (5) total count of ultimate children across the full corporate tree. Data sourced live from GLEIF Level-2 relationship records.","failureModes":["Invalid or malformed LEI (not 20 characters) returns a 400 error","LEI not found in GLEIF database returns a 404 or empty result","Entity has no parent (e.g. ultimate parent itself) returns null for parent fields","GLEIF data source temporarily unavailable causes 503 or timeout","childLimit outside 1-50 range returns a validation error","Entity exists but has no Level-2 relationship data filed returns empty ownership fields"],"whenToPreferThis":"Use this endpoint when you need live GLEIF-sourced corporate ownership relationships — specifically who owns whom — for a known LEI. Ideal for KYB workflows, beneficial ownership analysis, corporate tree mapping, sanctions screening, and M&A due diligence. Prefer this over general business lookup endpoints when the LEI is already known and ownership/control structure is the primary need. Complements entity reference lookups (business.lei) and ISIN-LEI mapping (business.lei-isins).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:11:14.709Z","isFirstParty":false}