# GLEIF LEI Ownership Graph Lookup

> GLEIF LEI Ownership Graph Lookup is a paid API for AI agents from x402-datashop-production.up.railway.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns GLEIF-sourced corporate ownership data for a given LEI: entity name/status, direct parent, ultimate parent, and direct children sample — all in a single call.

## Facts

- Endpoint: GET https://x402-datashop-production.up.railway.app/v1/lei/ownership
- Price: $0.005/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-ownership-graph-lookup-a0da21cd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hjn_80CuVdWpMytSvCyHk

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-ownership-graph-lookup-a0da21cd
```

Example prompt: Can you look up who owns the entity with LEI 5493001KJTIIGC8Y1R12 — I need its direct parent, ultimate parent, and a sample of its direct subsidiaries from the GLEIF registry?

## When to prefer this

Use this endpoint when you need structured GLEIF corporate ownership data (parent/subsidiary relationships) for a known LEI code in a single efficient call, rather than making multiple raw GLEIF API calls yourself. Ideal for compliance workflows, KYC enrichment, or financial research requiring ISO 17442 entity hierarchy data. Prefer over raw GLEIF API when you want consolidated entity + parent + children data in one request with caching.

## Known failure modes

- Unknown or unregistered LEI returns found=false with no ownership data
- Malformed LEI (not 20 characters or invalid format) may return an error or found=false
- Entity may exist but have no declared parent (orphan entity in GLEIF)
- Cache may return data up to 24 hours old — not suitable for real-time status checks
- Payment failure (x402) if USDC balance is insufficient

## How this service works

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.

## Output

Returns a JSON object with: found (boolean), entity name and status, declared direct parent LEI and name, ultimate parent LEI and name, total count of direct children, and a sample of up to 10 direct children entities. Data sourced from GLEIF's official LEI graph, cached for 24 hours. Returns found=false for unknown LEIs.

## 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"
   ],
   "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gleif-lei-ownership-graph-lookup-a0da21cd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-datashop-production.up.railway.app](https://www.zero.xyz/host/x402-datashop-production.up.railway.app/llms.txt)