# GLEIF LEI Record Lookup by LEI Code

> GLEIF LEI Record Lookup by LEI Code is a paid API for AI agents from lookups.alienprobe.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns a single legal entity identifier (LEI) record from a pinned GLEIF Level 1 snapshot, including entity name, registration status, and related metadata.

## Facts

- Endpoint: GET https://lookups.alienprobe.ai/v1/lookup/lei/00EHHQ2ZHDCFXJCPCL46
- 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/gleif-lei-record-lookup-by-lei-code-d6b86a81
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_h00qQhYfYkPla3niJl4ck

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-record-lookup-by-lei-code-d6b86a81
```

Example prompt: Look up the GLEIF LEI record for entity identifier 00EHHQ2ZHDCFXJCPCL46 and tell me the legal entity name and registration status.

## When to prefer this

Use this endpoint when you need a fast, low-cost, deterministic single-fact lookup of a GLEIF LEI record by its 20-character LEI code, and can tolerate data pinned to a recent snapshot rather than live GLEIF data. Prefer it over live GLEIF API calls when cost predictability and snapshot reproducibility matter, or when integrating LEI lookups into micropayment-gated agent workflows via the x402 protocol. Not suitable when you need the full GLEIF universe (only 20,000 records bundled) or real-time registration changes.

## Known failure modes

- LEI not found in snapshot even though it is checksum-valid — the snapshot only covers 20,000 records in ascending LEI order; valid LEIs outside this range will return no result
- LEI was refused by the bundle sanitizer during snapshot creation and is absent from this snapshot
- Snapshot is stale — data is pinned to the 2026-08-15 digest and does not reflect live GLEIF updates
- Invalid LEI format in path parameter — malformed identifiers will return an error
- Payment failure — x402 micropayment of $0.005 USDC must succeed before the lookup is processed

## How this service works

Paid single-fact lookups, answered from bundled digest-pinned snapshots of public reference data.

## Output

Returns a structured LEI record from a pinned GLEIF Level 1 snapshot (vintage 2026-08-15, 20,000 active/issued records), including entity name, registration and entity status, and snapshot provenance metadata (source name, SHA-256 digest, coverage notes). Coverage is bounded — not all GLEIF records are present, only those in the bundled subset.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "pathParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "lei"
     ],
     "properties": {
      "lei": {
       "type": "string",
       "pattern": "^[0-9A-Z]{20}$",
       "description": "the 20-character ISO 17442 legal entity identifier to resolve"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "example"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "required": [
      "schema_version",
      "subject",
      "answer",
      "source",
      "delivered_at"
     ],
     "properties": {
      "answer": {
       "type": "object",
       "required": [
        "lei",
        "legal_name",
        "jurisdiction",
        "entity_status",
        "registration_status",
        "last_update"
       ],
       "properties": {
        "lei": {
         "type": "string",
         "pattern": "^[0-9A-Z]{20}$",
         "description": "the 20-character ISO 17442 legal entity identifier to resolve"
        },
        "legal_name": {
         "type": "string",
         "minLength": 1
        },
        "last_update": {
         "type": "string",
         "minLength": 1
        },
        "jurisdiction": {
         "type": "string",
         "minLength": 1
        },
        "entity_status": {
         "type": "string",
         "minLength": 1
        },
        "registration_status": {
         "type": "string",
         "minLength": 1
        }
       },
       "additionalProperties": false
      },
      "source": {
       "type": "object",
       "required": [
        "name",
        "vintage",
        "snapshot_sha256",
        "coverage"
       ],
       "properties": {
        "name": {
         "type": "string",
         "const": "GLEIF golden copy, Level 1 LEI records admitted by the build (see coverage); domain map from Wikidata items carrying P1278 (LEI) and P856 (official website)"
        },
        "vintage": {
         "type": "string",
         "const": "2026-09-03"
        },
        "coverage": {
         "type": "string",
         
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "answer": {
   "lei": "00EHHQ2ZHDCFXJCPCL46",
   "legal_name": "Vanguard Fiduciary Trust Company Vanguard Russell 1000 Growth Index Trust",
   "last_update": "2026-05-29T12:21:14Z",
   "entity_status": "ACTIVE",
   "legal_jurisdiction": "US-PA",
   "registration_status": "ISSUED",
   "initial_registration_date": "2012-10-05T20:30:00Z"
  },
  "source": {
   "name": "GLEIF Level 1 LEI reference data (legal entity records), Access Service",
   "vintage": "2026-08-15",
   "coverage": "Bounded subset of the GLEIF Level 1 pool: 20000 LEI records, cut in ascending LEI order from the 1953582 records whose entity status is ACTIVE and whose registration status is ISSUED at the retrieval recorded in this module. 20200 candidates were read in that order, 21 were refused by the bundle sanitizer (guard-vocabulary and format screens), and the admitted remainder was cut at 20000. Some of those refusals fall INSIDE this LEI range, so a checksum-valid LEI can be missing here even when it sorts within the range — and a LEI missing here is missing from THIS snapshot only, never from the Global LEI System, which holds far more records than are bundled. Growing coverage is a bigger snapshot and a redeploy, never a live fetch.",
   "snapshot_sha256": "a56f5561e2cc620fc50a3bdaa88478f37eb1cdaf5e72c41129dc681a8dd34805"
  },
  "subject": {
   "type": "lei",
   "value": "00EHHQ2ZHDCFXJCPCL46"
  },
  "delivered_at": "2026-08-22T00:00:00.000Z",
  "schema_version": "lei-lookup.v1"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gleif-lei-record-lookup-by-lei-code-d6b86a81/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from lookups.alienprobe.ai](https://www.zero.xyz/host/lookups.alienprobe.ai/llms.txt)