# LEI Lookup (GLEIF)

> LEI Lookup (GLEIF) is a paid API for AI agents from api.stablecoingateways.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-30).

Look up a company's Legal Entity Identifier (LEI) by name or LEI code, returning full GLEIF record including legal name, jurisdiction, status, addresses, and parent company chain.

## Facts

- Endpoint: GET https://api.stablecoingateways.com/v1/lei?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lei-lookup-gleif-b5622a7c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_v2gqBroGaG-mCNkJnswFD

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 lei-lookup-gleif-b5622a7c
```

Example prompt: Can you look up the LEI for Apple Inc. and tell me their jurisdiction, registered address, and whether they have any parent companies on record?

## When to prefer this

Choose this endpoint when you need authoritative, globally-standardized legal entity identification data sourced directly from GLEIF — the official global LEI repository. It is ideal for KYB, counterparty due diligence, sanctions screening enrichment, and corporate ownership chain analysis. Prefer it over manual registry searches when you need machine-readable, CC0-licensed entity data with a verifiable signed receipt. It covers entities globally, unlike jurisdiction-specific company registries.

## Known failure modes

- Company name search returns no match (found: false) if name doesn't match GLEIF index
- Ambiguous name may return the closest match rather than exact target — verify LEI in response
- Invalid LEI format (not 20 alphanumeric chars) returns a validation error
- Some entities may have no parent data even if parents exist (not yet filed with GLEIF)
- Rate limiting or payment failure returns HTTP 402 requiring USDC payment via x402 protocol

## How this service works

LEI lookup (GLEIF): find a company's Legal Entity Identifier by name, or get the full record by LEI: legal name, jurisdiction, status, registered and headquarters address, and direct and ultimate parent companies. Use for KYB, counterparty identification and corporate ownership checks. Global coverage, CC0 data. Signed receipt.

## Output

Returns a JSON object with a 'found' boolean and, if found, a full GLEIF record including the 20-character LEI, legal name, alternate names, jurisdiction code, entity status, legal form ID, registered-as identifier, BIC codes, legal address, headquarters address, direct parent LEI, and ultimate parent LEI. Also includes data source attribution, retrieval timestamp, and an Ed25519-signed receipt with price, transaction hash, and verifiable request/response hashes.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "lei": {
       "type": "string",
       "pattern": "^[A-Za-z0-9]{18}[0-9]{2}$",
       "description": "20-character LEI (give lei or name)"
      },
      "name": {
       "type": "string",
       "maxLength": 120,
       "minLength": 2,
       "description": "Legal name search"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data",
      "receipt"
     ],
     "properties": {
      "data": {
       "type": "object",
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "properties": {
        "found": {
         "type": "boolean"
        },
        "record": {
         "type": "object",
         "properties": {
          "bic": {
           "type": "array",
           "items": {
            "type": "string"
           }
          },
          "lei": {
           "type": "string"
          },
          "category": {
           "type": "string"
          },
          "legal_name": {
           "type": "string"
          },
          "other_names": {
           "type": "array",
           "items": {
            "type": "string"
           }
          },
          "jurisdiction": {
           "type": "string"
          },
          "registration": {
           "type": "object"
          },
          "entity_status": {
           "type": "string"
          },
          "legal_address": {
           "type": "object"
          },
          "legal_form_id": {
           "type": "string"
          },
          "registered_as": {
           "type": "string"
          },
          "headquarters_address": {
           "type": "object"
          }
         }
        },
        "source": {
         "type": "string"
        },
        "provenance": {
         "typ
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "found": true,
   "record": {
    "lei": "HWUPKR0MPOU8FGXBT394",
    "legal_name": "Apple Inc.",
    "other_names": [
     "Apple Computer, Inc."
    ],
    "jurisdiction": "US-CA",
    "legal_form_id": "H1UM"
   },
   "source": "GLEIF Global LEI Index (CC0 1.0), https://www.gleif.org",
   "retrieved_at": "2026-10-22T00:39:44.411Z",
   "direct_parent": null,
   "ultimate_parent": null
  },
  "receipt": {
   "v": 1,
   "ts": "2026-10-22T09:00:00Z",
   "sig": "hex",
   "price": {
    "asset": "USDC",
    "amount": "2000",
    "network": "eip155:84532"
   },
   "log_seq": 1,
   "tx_hash": "0x..",
   "endpoint_id": "lei-lookup-v1",
   "request_hash": "hex",
   "response_hash": "hex"
  }
 }
}
```

## More

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