# CelerAPI LEI Relationships Lookup

> CelerAPI LEI Relationships Lookup is a paid API for AI agents from www.celerapi.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Retrieves the corporate relationship data (parent, child, ultimate parent) for a legal entity identified by its LEI code

## Facts

- Endpoint: GET https://www.celerapi.com/v1/lei/%7Blei%7D/relationships
- 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/celerapi-lei-relationships-lookup-a4cf7394
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_blqacjCbYMHWdJAvn78uX

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 celerapi-lei-relationships-lookup-a4cf7394
```

Example prompt: Can you pull the corporate relationships — parent company, ultimate parent, and any children — for the legal entity with LEI code 5493001KJTIIGC8Y1R12?

## When to prefer this

Use this endpoint when you need live, structured LEI relationship data (parent/child/ultimate parent) for a specific legal entity and want to avoid building a GLEIF API integration yourself. Ideal for compliance, KYC, counterparty risk, or regulatory reporting workflows where corporate ownership hierarchy is needed and freshness matters. Prefer over direct GLEIF API calls when you need pay-per-request access without API key management.

## Known failure modes

- Invalid or malformed LEI code returns an error or empty data
- LEI not found in GLEIF registry returns empty relationships
- Network or GLEIF upstream outage causes delayed or failed response
- Relationship data incomplete when GLEIF source is partially available (reflected in warnings array)
- Payment failure (HTTP 402) if USDC payment is not included or is insufficient

## How this service works

Resolve companies, legal entities and financial reference data using authoritative sources. Machine-native, pay per request, no subscription.

## Output

Returns a JSON object with a `data` field containing the entity's LEI relationships (direct parent, ultimate parent, children) as sourced live from the GLEIF API, along with `success` and `complete` flags, any `warnings`, and provenance metadata indicating the GLEIF source, CC0 1.0 license, and live freshness.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "success": true,
  "complete": true,
  "warnings": [],
  "provenance": {
   "source": "Global Legal Entity Identifier Foundation",
   "license": "CC0 1.0",
   "provider": "gleif",
   "freshness": "live",
   "source_url": "https://api.gleif.org"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/celerapi-lei-relationships-lookup-a4cf7394/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.celerapi.com](https://www.zero.xyz/host/www.celerapi.com/llms.txt)