# Corporate Ownership and LEI Group Structure

> Corporate Ownership and LEI Group Structure is a paid API for AI agents from x402-filings.datalayer.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-09).

Resolves a company name or LEI to its full GLEIF ownership graph, returning direct parent, ultimate parent, and direct children with jurisdictions spanned.

## Facts

- Endpoint: GET https://x402-filings.datalayer.workers.dev/v1/corp/ownership?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-09
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/corporate-ownership-and-lei-group-structure-13494135
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2e-IiRB_8FjVXrTUg75pj

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 corporate-ownership-and-lei-group-structure-13494135
```

Example prompt: Can you look up the full ownership structure for Stripe — find their LEI, who the direct parent is, who the ultimate parent is, and what jurisdictions the group spans?

## When to prefer this

Choose this endpoint when you need authoritative, structured corporate ownership data tied to LEIs (the global standard for legal entity identification), especially for KYC, AML, sanctions screening, or counterparty due diligence workflows. Prefer this over general web search or company databases when you need machine-readable parent/child relationships across jurisdictions and need the GLEIF canonical record rather than informal ownership claims.

## Known failure modes

- Company name not found in GLEIF registry — try alternate name spellings or adding a country filter
- LEI not found or expired/lapsed — entity may have merged, dissolved, or not registered
- Ambiguous name returns multiple candidates — use country parameter to narrow results
- No parent or child data available — some entities have incomplete GLEIF reporting
- Rate limit or payment failure — x402 payment of $0.02 USDC must succeed per call

## How this service works

Who actually owns a counterparty. Resolves a company to its Legal Entity Identifier and walks the GLEIF ownership graph — direct parent, ultimate parent and direct children — returning the group structure with the jurisdictions it spans. This is the entity-resolution step under every KYC, sanctions and diligence workflow: free lookups answer the name, almost nothing answers the group. Search by name and country, then resolve by LEI.

## Output

Returns the matched entity's LEI, registered name, and jurisdiction, along with its direct parent (with LEI and jurisdiction), ultimate parent (with LEI and jurisdiction), and a list of direct child entities. Also includes a group summary showing all jurisdictions spanned by the corporate structure.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "lei": {
       "type": "string",
       "examples": [
        "549300B56MD0ZC402L06"
       ],
       "description": "20-character LEI. When given, returns that entity plus its parents, children and group summary."
      },
      "name": {
       "type": "string",
       "examples": [
        "Stripe"
       ],
       "description": "Company name to search for. Use instead of lei to find candidates."
      },
      "limit": {
       "type": "integer",
       "examples": [
        10
       ],
       "description": "Max entities in search mode, 1-50. Default 10."
      },
      "country": {
       "type": "string",
       "examples": [
        "US"
       ],
       "description": "ISO 3166-1 alpha-2 country code to narrow a name search."
      }
     }
    }
   },
   "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/corporate-ownership-and-lei-group-structure-13494135/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-filings.datalayer.workers.dev](https://www.zero.xyz/host/x402-filings.datalayer.workers.dev/llms.txt)
