{"uid":"cap_h3y21pBP-rFASdmX_uxQ-","slug":"invoket-company-ownership-chain-lookup-f0f9ef4d","name":"Invoket Company Ownership Chain Lookup","description":"The checks your agent runs before it acts: verify a bank account, a phone number, a law in force, the weather or a vehicle — computed from official sources, with provenance in every response. You only pay for answers.","url":"https://api.invoket.com/company/ownership","method":"POST","headers":{},"bodySchema":{"type":"object","required":["lei","depth","direction"],"properties":{"lei":{"type":"string","description":"20-character LEI (ISO 17442, check digits verified) of the entity to look up - required. Get it from /company/lei if you only hold a SIREN, a BIC or a name. A well-formed LEI absent from the reference is a 404, unbilled, with the same message as /company/lei"},"depth":{"type":"string","description":"Chain depth, 1 to 5 (default 3). A HARD bound: out of range is a 400, never a silent trim - an agent that asks for 7 must know it was not served 7. When the walk stops on the bound, 'chain_truncated' says so, and the declared ultimate parent is still served"},"direction":{"type":"string","description":"'up' (default) walks the parents, 'down' returns 'direct_children' - the entities declaring this LEI as their direct parent, capped at 100 with 'total_children' exact - and 'both' does both. Only DIRECT subsidiaries are served, there is no multi-level org chart. A block you did not ask for is null, which is distinct from [] meaning 'asked, nothing declared'"}}},"responseSchema":{"type":"object"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qsBEkFsc1I_k8zm220-FK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Walks the corporate ownership chain of a legal entity by LEI, returning parent and/or direct subsidiary relationships with provenance from official sources.","exampleAgentPrompt":"Can you walk the ownership chain for the entity with LEI 2138004GZR1TZJVMK895 — go up 3 levels to find its parents and also show me its direct children?","exampleUseCases":[{"title":"KYC pre-payment ownership check","prompt":"Before we wire funds to this counterparty, can you look up their ownership chain using LEI 5493001KJTIIGC8Y1R12, going up 4 levels, so we can confirm who ultimately controls them?"},{"title":"Subsidiary discovery for due diligence","prompt":"I need to find all direct subsidiaries of the holding company with LEI 2594007XIACKNMUAW223 — can you pull the down direction so I know which entities it directly owns?"},{"title":"Ultimate parent identification for compliance","prompt":"We need to flag the ultimate parent of LEI 969500T3MBS4SQAMHJ45 for our sanctions screening — can you walk up 5 levels and tell me if the chain gets truncated anywhere?"}],"resultDescription":"Returns a structured object containing the ownership chain in the requested direction(s): an 'up' block with parent entities up to the specified depth (with a 'chain_truncated' flag if the depth limit was hit and the declared ultimate parent), a 'down' block with direct children (capped at 100 with an exact 'total_children' count), or both. Blocks not requested are null (distinct from [] meaning no children declared). Each entity record includes provenance from the official GLEIF registry. Returns 404 (unbilled) for a well-formed LEI absent from the registry, and 400 for out-of-range depth.","failureModes":["404 returned (and not billed) when a syntactically valid LEI is not found in the GLEIF registry","400 returned when depth is outside 1–5 range — no silent trimming occurs","400 returned if direction is not 'up', 'down', or 'both'","400 returned if LEI is malformed or fails ISO 17442 check-digit verification","Ownership data may lag real-world changes if GLEIF registry updates are pending","'chain_truncated' flag set when walk stops at the requested depth before reaching the ultimate parent","'total_children' may exceed 100 but only 100 direct subsidiaries are returned in the down block"],"whenToPreferThis":"Use this endpoint when you need machine-verifiable, provenance-backed corporate ownership data sourced directly from the GLEIF registry, particularly in compliance, KYC, sanctions screening, or due diligence workflows where accuracy and auditability matter. Prefer it over web-scraping or unstructured data sources when you need a reliable chain with explicit truncation signals and an exact subsidiary count. It is especially useful when you already hold a LEI (or can resolve one via the sibling /company/lei endpoint) and need to traverse parent or child relationships in a controlled, bounded way.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:43:41.937Z","isFirstParty":false}