# GLEIF LEI Single-Record Lookup (GLEIF Level 1 Snapshot)

> GLEIF LEI Single-Record Lookup (GLEIF Level 1 Snapshot) is a paid API for AI agents from ccs-seller.bbrysonelite.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns structured GLEIF Level 1 legal entity data for a single LEI from a bundled 20,000-record CC0 snapshot (vintage 2026-08-15), refusing unknown or malformed LEIs by name.

## Facts

- Endpoint: GET https://ccs-seller.bbrysonelite.workers.dev/v1/lookup/lei/00EHHQ2ZHDCFXJCPCL46
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gleif-lei-single-record-lookup-gleif-level-1-snapshot-a3b16b76
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uYtdUThdRMPOOB4ZXyCwu

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-single-record-lookup-gleif-level-1-snapshot-a3b16b76
```

Example prompt: Look up the legal entity information for LEI 00EHHQ2ZHDCFXJCPCL46 and tell me whether it's active and issued according to the GLEIF Level 1 snapshot.

## When to prefer this

Choose this endpoint when you need a fast, deterministic, offline-style lookup of a single LEI against a known GLEIF Level 1 snapshot without hitting GLEIF's live API. Ideal for compliance pipelines, KYC enrichment, or any workflow where reproducibility against a fixed vintage (2026-08-15, SHA-256 verified) matters. Prefer this over live GLEIF lookups when auditability and cost predictability ($0.005/call) are priorities, and when coverage of 20,000 ACTIVE/ISSUED records is sufficient for your use case.

## Known failure modes

- LEI is checksum-valid but not present in the 20,000-record snapshot — returns absence notice clarifying it may exist in the full GLEIF system
- Malformed or syntactically invalid LEI — refused by name with an explicit error, never guessed
- LEI was excluded by the bundle sanitizer (guard-vocabulary/format screen) — absent from snapshot even if it sorts within the covered range
- LEI exists in GLEIF but post-dates or predates the 2026-08-15 snapshot vintage — not present in this bundle

## How this service works

single-fact lei lookup. Answers from a bundled CC0 subset of GLEIF Level 1 data, vintage 2026-08-15: 20000 ACTIVE, ISSUED records cut in ascending LEI order from a 1953582-record pool. The range is not dense, so a valid LEI can sort inside it and still be absent; absence here is absence from THIS snapshot, never from the Global LEI System. An unknown or malformed LEI is refused by name, never guessed. The full bound is stated free in the discovery declaration on this challenge.

## Output

A JSON object containing the matched LEI record's entity and registration fields drawn from the bundled GLEIF Level 1 snapshot (vintage 2026-08-15, 20,000 ACTIVE/ISSUED records), plus source metadata including snapshot SHA-256, coverage description, and schema version. If the LEI is absent from the snapshot or malformed, the service refuses with a named error rather than guessing.

## 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
{
 "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"
 },
 "schema_version": "lei-lookup.v1"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gleif-lei-single-record-lookup-gleif-level-1-snapshot-a3b16b76/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ccs-seller.bbrysonelite.workers.dev](https://www.zero.xyz/host/ccs-seller.bbrysonelite.workers.dev/llms.txt)