# GLEIF LEI Lookup

> GLEIF LEI Lookup is a paid API for AI agents from gleif.openverbs.com, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-13).

Resolves a 20-character Legal Entity Identifier (LEI) to its authoritative GLEIF entity record including legal name, registration status, jurisdiction, addresses, and key dates

## Facts

- Endpoint: POST https://gleif.openverbs.com/v1/lookup
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gleif-lei-lookup-631cce85
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KpY0g9y8ZoXV08lbgyPho

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-lookup-631cce85 -d '<json body>'
```

Example prompt: Can you look up the GLEIF record for LEI 5493001KJTIIGC8Y1R12 and tell me the company's legal name, registration status, and jurisdiction?

## When to prefer this

Use this endpoint when you have an exact 20-character LEI code and need authoritative, ISO 17442-compliant entity data directly from the GLEIF registry. Prefer this over name-based search when you already know the LEI and need verified legal details for KYC, trade reporting, regulatory compliance, or entity enrichment workflows. The sibling name-search endpoint should be used first if you only have a company name and need to discover the LEI.

## Known failure modes

- Invalid LEI format (not 20 alphanumeric characters) — check digit validation fails before payment
- LEI not found in GLEIF registry — entity may not exist or was never registered
- Lapsed or retired LEI — record returned but status indicates inactive entity
- Network timeout or upstream GLEIF API unavailability — transient error
- Payment failure — x402 USDC payment not completed, no lookup performed

## How this service works

Resolve a 20-character Legal Entity Identifier (LEI, ISO 17442) to its authoritative entity record: verified legal name, registration status (ISSUED/LAPSED/RETIRED), entity status, jurisdiction, legal form, registration number, legal and headquarters addresses, key dates (registration, last update, next renewal), managing LOU, corroboration level and any BIC codes. ISO 7064 check digits are verified before payment.

## Output

Returns the authoritative GLEIF entity record for the given LEI, including: verified legal name, registration status (ISSUED/LAPSED/RETIRED), entity status, jurisdiction, legal form code, local registration number, legal and headquarters addresses (street, city, country, postal code), key dates (registration, last update, next renewal), managing Local Operating Unit (LOU), corroboration level, and any associated BIC codes. ISO 7064 check digits are validated before the payment is processed.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "lei"
     ],
     "properties": {
      "lei": {
       "type": "string",
       "maxLength": 20,
       "minLength": 20,
       "description": "20-character alphanumeric Legal Entity Identifier (ISO 17442), e.g. \"5493001KJTIIGC8Y1R12\"."
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

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