{"uid":"cap_KU44KheqITnTjZRR9yJ8l","slug":"fittings-lei-ownership-hierarchy-d625ac60","name":"fittings LEI Ownership Hierarchy","description":"GLEIF 'who owns whom' for an LEI: direct and ultimate accounting parent, any reporting exception, and known direct subsidiaries.","url":"https://fittings.sh/v1/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"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["lei"],"properties":{"lei":{"type":"string","description":"20-character ISO 17442 identifier"},"limit":{"type":"number","description":"Direct children to return, 1-25, default 10"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0074","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.0074/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0074","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0074","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_G3ws8eJOyXu8_2UML4N9w","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0074","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the GLEIF-sourced ownership hierarchy for a given LEI: direct parent, ultimate parent, reporting exceptions, and known direct subsidiaries.","exampleAgentPrompt":"Can you pull the full ownership hierarchy for LEI 529900T8BM49AURSDO55 — I need the direct parent, ultimate parent, and up to 15 direct subsidiaries?","exampleUseCases":[{"title":"KYB ultimate beneficial owner check","prompt":"I need to verify who ultimately owns the entity with LEI 2138002658TAABZK6J24 — give me the direct and ultimate accounting parent, and flag any reporting exceptions."},{"title":"Subsidiary discovery for due diligence","prompt":"Can you list the known direct subsidiaries of LEI 5493001KJTIIGC8Y1R12? I'd like up to 20 of them if available."},{"title":"Supply chain counterparty ownership mapping","prompt":"We're onboarding a new supplier with LEI 969500CHL179NB74PX24 — can you tell me who owns them, all the way up to the ultimate parent?"}],"resultDescription":"Returns a structured JSON object containing the entity's direct accounting parent (with LEI and name), ultimate accounting parent (with LEI and name), any GLEIF reporting exception with reason, and a paginated list of known direct subsidiaries (each with LEI, name, and relationship type), all sourced from GLEIF relationship records.","failureModes":["Invalid or malformed LEI (not 20 characters, bad checksum) returns a validation error","LEI exists but has no registered parent (orphan entity) returns null parent fields","GLEIF relationship data not yet published for entity returns empty hierarchy","limit parameter out of range (below 1 or above 25) returns a 400 error","GLEIF upstream data lag may mean recently registered LEIs have no hierarchy data yet"],"whenToPreferThis":"Choose this endpoint when you need authoritative GLEIF-sourced corporate ownership data for a specific LEI, particularly for KYB/KYC workflows, regulatory compliance, due diligence, or counterparty risk assessment. It is preferred over general corporate registry lookups when the ISO 17442 LEI is known and GLEIF relationship data is the required authoritative source. It is not suitable for searching entities by name without a known LEI.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:54:54.288Z","isFirstParty":false}