# LEI Company Lookup

> LEI Company Lookup is a paid API for AI agents from api.facts402.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-04).

Look up a legal entity by 20-character LEI code or search by company name in the GLEIF Global LEI Index, returning legal name, status, jurisdiction, addresses, registration dates, and parent entity relationships.

## Facts

- Endpoint: POST https://api.facts402.com/lei?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-04
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lei-company-lookup-93be9ec5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CSdgKe86u6ZPO9TOo0A6F

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 lei-company-lookup-93be9ec5 -d '<json body>'
```

Example prompt: Can you look up the legal entity details for LEI code 7H6GLXDRUGQFU57RNE47 in the GLEIF index — I need the legal name, status, jurisdiction, and any parent entity info?

## When to prefer this

Use this endpoint when you need authoritative legal entity data from the official GLEIF Global LEI Index — particularly for KYB, corporate onboarding, counterparty verification, or compliance workflows. Prefer this over generic business search APIs when you need structured, regulated data including parent entity hierarchies, registration status, and jurisdiction. It supports both precise lookup by LEI code and fuzzy discovery by company name.

## Known failure modes

- Invalid LEI format (not 20 alphanumeric characters) returns validation error
- LEI not found in GLEIF index returns empty result
- Company name search with no matches returns empty candidates list
- Ambiguous or very common company name may return irrelevant candidates
- GLEIF upstream unavailability may cause timeout or error
- Neither LEI nor name provided results in bad request error

## How this service works

Use when an agent needs an LEI lookup for KYB, onboarding or counterparty checks: from the official GLEIF index, by 20-char LEI get legal name, status, jurisdiction, legal and HQ address, registration dates, corroboration level and direct/ultimate parent; or search by company name (up to 5 candidates). $0.01 USDC on Base; charged only on 2xx, never for invalid input.

## Output

Returns structured data from the GLEIF Global LEI Index including: legal name, LEI status (active/lapsed/etc.), jurisdiction of registration, legal address, HQ address, LEI registration and last-update dates, corroboration level, and direct/ultimate parent LEI codes. When searching by name, returns up to 5 matching candidate entities.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lei": {
   "anyOf": [
    {
     "type": "string",
     "pattern": "^[A-Za-z0-9 ]{20,24}$"
    },
    {
     "type": "null"
    }
   ],
   "title": "Lei",
   "default": null,
   "description": "20-character LEI code"
  },
  "name": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 200,
     "minLength": 2
    },
    {
     "type": "null"
    }
   ],
   "title": "Name",
   "default": null,
   "description": "Legal name to search for"
  }
 }
}
```

## More

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