# GLEIF LEI Ownership Graph Lookup

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

Retrieves corporate ownership structure for a legal entity by LEI — including entity name/status, direct parent, ultimate parent, and direct children — from the official GLEIF registry.

## Facts

- Endpoint: GET https://data.greeneris.io/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-ca7044fe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SdMcphbAMCioyLuC4g3Gq

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-ca7044fe
```

Example prompt: Can you look up the full ownership structure for the legal entity with LEI 5493001KJTIIGC8Y1R12 — I need to know its name and status, who its direct and ultimate parent are, and how many direct children it has?

## When to prefer this

Use this endpoint when you need a single-call view of a legal entity's full ownership hierarchy — direct parent, ultimate parent, and children — from the authoritative GLEIF registry. Prefer this over scraping GLEIF directly or calling multiple GLEIF APIs, as it aggregates four lookups into one call with a 24-hour cache. Ideal for KYC, AML, counterparty due diligence, or regulatory research workflows where LEI-based ownership tracing is required.

## Known failure modes

- Unknown or invalid LEI returns found=false with no ownership data
- Malformed LEI (not 20 characters or wrong format) may return a validation error
- Entities with no declared parent return null parent fields
- Cached data may be up to 24 hours stale relative to GLEIF updates
- Payment failure (x402) returns 402 if USDC payment is not provided

## 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

A JSON object indicating whether the LEI was found (found: true/false), along with the entity's name and registration status, its declared direct parent LEI and name, its ultimate parent LEI and name, and the total count plus a 10-entity sample of its direct children. Data is sourced from the GLEIF LEI graph (CC0 licensed) and cached for 24 hours.

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "lei": "549300B56MD0ZC402L06",
  "name": "Bloomberg L.P.",
  "found": true,
  "source": "GLEIF (CC0)",
  "status": "ACTIVE",
  "direct_parent": {
   "lei": "549300RMUDWPHCUQNE66",
   "name": "Bloomberg Inc."
  },
  "children_total": 27,
  "children_sample": [
   {
    "lei": "254900PNPB5L5VNJNS35",
    "name": "BLOOMBERG BETA 2016 L.P."
   },
   {
    "lei": "254900JY1M565T6QM850",
    "name": "Bloomberg Finance Singapore L.P."
   }
  ],
  "ultimate_parent": {
   "lei": "549300RMUDWPHCUQNE66",
   "name": "Bloomberg Inc."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gleif-lei-ownership-graph-lookup-ca7044fe/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.greeneris.io](https://www.zero.xyz/host/data.greeneris.io/llms.txt)