# GLEIF LEI Index Lookup via x402

> GLEIF LEI Index Lookup via x402 is a paid API for AI agents from x402.tuancodes.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-24).

Retrieves Legal Entity Identifier (LEI) data including entity status, corporate hierarchy, and registration details from the GLEIF Global LEI Index for a given LEI code.

## Facts

- Endpoint: HEAD https://x402.tuancodes.workers.dev/lei/%7Blei%7D?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gleif-lei-index-lookup-via-x402-16bb41ca
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_u2nL4dvvlh62Yu3CX6_oH

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-index-lookup-via-x402-16bb41ca -d '<json body>'
```

Example prompt: Can you pull the full GLEIF LEI record for the entity with LEI code 529900I8XOZDM4ZQSQ21 — I need their registration status, renewal date, and parent company details?

## When to prefer this

Choose this endpoint when you need authoritative, deterministic LEI resolution from the official GLEIF Global LEI Index without scraping or AI-generated data. Ideal for compliance workflows, KYC/AML checks, or corporate hierarchy research where data provenance matters. The pay-per-call x402 model means no subscription required and failed lookups are not billed, making it cost-efficient for sporadic or automated queries.

## Known failure modes

- LEI not found in GLEIF index — returns not-found result, no charge applied
- GLEIF upstream API timeout or 5xx error — request fails, no charge applied
- Malformed or invalid LEI format in path parameter — likely 4xx response
- LEI exists but entity has been deregistered — returns record with non-ACTIVE status

## How this service works

Deterministic lookups from official public sources (ARES, EU VIES, Czech National Bank, GLEIF LEI index). No AI, no scraping. Pay per call in USDC on Base via x402. Requests that fail upstream (5xx/timeout) or not-found results are not charged.

## Output

Returns a JSON object containing the LEI code, legal entity name, data source attribution (GLEIF, CC0), jurisdiction, registration status and next renewal date, direct and ultimate parent entities with their LEI codes and names, entity status (ACTIVE/INACTIVE), legal address (street lines, city, region, postal code, country), and local registry identifiers (authority ID and registered number).

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "lei": "529900I8XOZDM4ZQSQ21",
  "name": "ŠKODA AUTO a.s.",
  "source": "GLEIF Global LEI Index (api.gleif.org), CC0",
  "jurisdiction": "CZ",
  "registration": {
   "status": "ISSUED",
   "next_renewal": "2027-10-25"
  },
  "direct_parent": {
   "lei": "529900NNUPAGGOMPXZ31",
   "name": "VOLKSWAGEN AKTIENGESELLSCHAFT"
  },
  "entity_status": "ACTIVE",
  "legal_address": {
   "city": "Mladá Boleslav",
   "lines": [
    "Tř. Václava Klementa 869"
   ],
   "region": "CZ-20",
   "postal_code": "293 01",
   "country_code": "CZ"
  },
  "local_registry": {
   "authority_id": "RA000163",
   "registered_as": "00177041"
  },
  "ultimate_parent": {
   "lei": "529900NNUPAGGOMPXZ31",
   "name": "VOLKSWAGEN AKTIENGESELLSCHAFT"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gleif-lei-index-lookup-via-x402-16bb41ca/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.tuancodes.workers.dev](https://www.zero.xyz/host/x402.tuancodes.workers.dev/llms.txt)