# GLEIF LEI Corporate Ownership Hierarchy Lookup

> GLEIF LEI Corporate Ownership Hierarchy Lookup is a paid API for AI agents from 2s.io, paid per call via x402, $0.0036/call, status unknown (last checked 2026-09-14).

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.

## Facts

- Endpoint: GET https://2s.io/api/business/lei-hierarchy
- Price: $0.0036/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gleif-lei-corporate-ownership-hierarchy-lookup-115291c6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4OpZ8mVSelxXRIwMSsz6-

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gleif-lei-corporate-ownership-hierarchy-lookup-115291c6
```

Example prompt: 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?

## When to prefer this

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).

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gleif-lei-corporate-ownership-hierarchy-lookup-115291c6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)