# GLEIF LEI Batch Lookup

> GLEIF LEI Batch Lookup is a paid API for AI agents from x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-30).

Batch-resolve up to 200 Legal Entity Identifiers (LEIs) to official GLEIF registry records including legal name, address, entity status, and registration details.

## Facts

- Endpoint: POST https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/company/lei/batch?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gleif-lei-batch-lookup-23db1c31
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lFBSUqNzKbi41lGfqkMFW

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-batch-lookup-23db1c31 -d '<json body>'
```

Example prompt: Can you look up the official GLEIF records for these LEIs: HWUPKR0MPOU8FGXBT394, 7LTWFZYICNSX8D621K86, and 2594007XIACKNMUAW223 — I need their legal names, entity status, and jurisdiction?

## When to prefer this

Use this endpoint when you need to resolve multiple LEIs (up to 200) in a single paid call at a fixed cost of $0.02, rather than making individual /company/lei calls per entity. Ideal for bulk compliance enrichment, onboarding pipelines, portfolio monitoring, or any workflow where you have a list of LEIs and need authoritative GLEIF data efficiently. Not suitable if you need parent/subsidiary relationships or BIC codes (use the single /company/lei endpoint for that). Does not cover L402-listed entities.

## Known failure modes

- None of the submitted LEIs found in GLEIF — call refused and not charged
- GLEIF API unavailable — call refused, nothing charged
- Invalid LEI format — individual result returns ok:false
- LEI exists but entity is lapsed or annulled — returned with entity_status reflecting that
- Batch exceeds 200 items — request rejected before payment

## How this service works

An open index of the machine-to-machine (agent) economy. x402 routes: ranked discovery over the live x402 service market, every indexed service scored by real 30-day calls and paying-wallet bounds, with a receipt naming the snapshot hash and scoring revision. /economy routes, for Tempo MPP, Virtuals ACP, Olas, Masumi, ERC-8004 agent registries, Solana agent registries, Base agent contracts and MCP servers (Official MCP Registry): each protocol's published figures (agent or server counts, transactions or payment events; payers and USD volume only where the source publishes them: payers for x402 and Tempo MPP, USD volume for x402 and Virtuals ACP), each with its unit, window and source; units differ, so totals are not summed. L402 listings are not covered.

## Output

A JSON object containing: a timestamp (as_of), source attribution to GLEIF, per-LEI results with ok flag, the resolved record including lei, legal_name, other_names, jurisdiction, entity_status, legal_address, headquarters_address, legal_form_code, registration details (status, managing_lou, dates, corroboration_level), a SHA-256 record_hash for change detection, and a count of successful lookups. Unresolvable LEIs return ok:false with status 404. Fixed price per call regardless of batch size (1–200 LEIs).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "leis": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 255
   },
   "maxItems": 200,
   "minItems": 1,
   "description": "1 to 200 LEIs; duplicates are removed"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Registry data exactly as GLEIF publishes it, all LEIs read in one GLEIF call; duplicates (case-insensitive) are removed. An LEI GLEIF does not hold is returned with ok false and status 404 (the call is refused unpaid only when none of them is found). record_hash is the SHA-256 of the item's fields (key-sorted JSON): equal hash = unchanged record. No parents or BIC here: use /company/lei for one entity in full. Not legal advice or a credit check. Fixed price per call for 1 to 200 LEIs; if GLEIF does not answer the call is refused and nothing is charged.",
  "as_of": "2026-10-25T09:20:00.000Z",
  "count": 1,
  "source": "GLEIF Global LEI Index",
  "results": [
   {
    "ok": true,
    "input": "HWUPKR0MPOU8FGXBT394",
    "result": {
     "lei": "HWUPKR0MPOU8FGXBT394",
     "category": "GENERAL",
     "legal_name": "Apple Inc.",
     "other_names": [
      {
       "name": "Apple Computer, Inc.",
       "type": "PREVIOUS_LEGAL_NAME"
      }
     ],
     "record_hash": "f043d55c035f47714392db7b99cc432dfda8f93d5f01748fcb02cec1dd425b52",
     "jurisdiction": "US-CA",
     "registration": {
      "status": "ISSUED",
      "managing_lou": "5493001KJTIIGC8Y1R12",
      "last_update_date": "2026-03-03",
      "next_renewal_date": "2027-03-08",
      "corroboration_level": "FULLY_CORROBORATED",
      "initial_registration_date": "2012-06-06"
     },
     "creation_date": "1977-01-03",
     "entity_status": "ACTIVE",
     "legal_address": {
      "city": "Glendale",
      "lines": [
       "C/O C T Corporation System",
       "330 N. Brand Blvd",
       "Suite 700"
      ],
      "region": "US-CA",
      "country": "US",
      "postal_code": "91203"
     },
     "registered_as": "806592",
     "legal_form_code": "H1UM",
     "last_update_date": "2026-03-03",
     "legal_form_other": null,
     "successor_entities": [],
     "headquarters_address": {
      "city": "Cupertino",
      "lines": [
       "One Apple Park Way"
      ],
      "region": "US-CA",
      "country": "US",
      "postal_code": "95014"
     },
     "registration_authority_id": "RA000598"
    }
   }
  ],
  "ok_count": 1,
  "checked_at": "2026-10-18T12:00:00.000Z",
  "source_url": "https://search.gleif.org/",
  "attribution": "LEI reference data: GLEIF (Global Legal Entity Identifier Foundation), api.gleif.org, CC0 1.0. This service is not provided, supported or endorsed by GLEIF or any LOU.",
  "golden_copy_date": "2026-10-25"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gleif-lei-batch-lookup-23db1c31/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev](https://www.zero.xyz/host/x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/llms.txt)