# GLEIF LEI Search — Global Legal Entity Identifier Lookup

> GLEIF LEI Search — Global Legal Entity Identifier Lookup is a paid API for AI agents from x402.tuancodes.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Searches the GLEIF Global LEI Index by company name to retrieve Legal Entity Identifier (LEI) codes and entity details for companies worldwide, sourced deterministically from official GLEIF data.

## Facts

- Endpoint: HEAD https://x402.tuancodes.workers.dev/lei-search?utm_source=zero.xyz
- Price: $0.002/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-search-global-legal-entity-identifier-lookup-7d7b0b0b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4l0XFaq5mKgj9psmUw57Y

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-search-global-legal-entity-identifier-lookup-7d7b0b0b -d '<json body>'
```

Example prompt: Search the GLEIF LEI index for 'Skoda Auto' and give me the LEI code, entity status, and registration status.

## When to prefer this

Use this endpoint when you need authoritative, deterministic LEI data sourced directly from the GLEIF Global LEI Index without AI inference or web scraping. Prefer it over general web search when you need machine-readable LEI codes for compliance, KYC, or financial onboarding workflows. Ideal when the company could be Czech, European, or globally registered. Pay-per-call pricing at $0.002 USDC means zero cost for not-found or upstream-error results.

## Known failure modes

- Company name not found in GLEIF index — no results array, not charged
- GLEIF upstream timeout or 5xx error — request not charged
- Ambiguous company name returns multiple results requiring disambiguation
- Non-Latin or special characters in company name may reduce match quality
- Very new or recently dissolved entities may not appear in GLEIF index

## 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 with the search query, total result count, data source attribution (GLEIF, CC0 licensed), country filter, and an array of matching entities each containing LEI code, company name, city, country code, entity status (e.g. ACTIVE), and registration status (e.g. ISSUED).

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "Skoda Auto",
  "total": 3,
  "source": "GLEIF Global LEI Index (api.gleif.org), CC0",
  "country": "CZ",
  "results": [
   {
    "lei": "529900I8XOZDM4ZQSQ21",
    "city": "Mladá Boleslav",
    "name": "ŠKODA AUTO a.s.",
    "country_code": "CZ",
    "entity_status": "ACTIVE",
    "registration_status": "ISSUED"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gleif-lei-search-global-legal-entity-identifier-lookup-7d7b0b0b/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)
