# GLEIF LEI Lookup via x402-endpoints

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

Looks up company information from the official GLEIF global registry using a Legal Entity Identifier (LEI), returning legal name, status, jurisdiction, legal form, and registered address.

## Facts

- Endpoint: GET https://x402-endpoints.onrender.com/gleif/lei?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gleif-lei-lookup-via-x402-endpoints-d3f610f6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_N6y2L02bGU3qstPZIxyRd

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-via-x402-endpoints-d3f610f6
```

Example prompt: Can you look up the company registered under LEI code 529900T8BM49AURSDO55 in the GLEIF global registry and tell me its legal name, status, jurisdiction, and registered address?

## When to prefer this

Use this endpoint when you need authoritative, real-time legal entity data from the official global GLEIF registry, particularly for KYB/compliance checks, counterparty due diligence, or verifying the legal status and registration details of any company worldwide. Prefer this over secondary data aggregators when you need the canonical source of truth for LEI-linked entity data.

## Known failure modes

- Invalid LEI format (not 20 uppercase alphanumeric characters) — schema validation error
- LEI not found in GLEIF registry — 404 or empty result
- GLEIF upstream unavailable — 502/503 timeout
- Payment not processed — 402 Payment Required
- Rate limiting or quota exceeded

## How this service works

Look up any Legal Entity Identifier (LEI) for company information lookup and counterparty / know-your-business (KYB) identity against the official GLEIF global registry — returns legal name, status, jurisdiction, legal form and registered address, real-time, worldwide coverage.

## Output

Returns structured company data from the GLEIF registry including the entity's legal name, entity status (active/inactive/etc.), jurisdiction of registration, legal form, and registered address — sourced in real time from the official global LEI database.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "lei"
     ],
     "properties": {
      "lei": {
       "type": "string",
       "pattern": "^[A-Z0-9]{20}$",
       "description": "20-character LEI, e.g. '529900T8BM49AURSDO55'"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "lei": "529900T8BM49AURSDO55",
  "cached": false,
  "source": "GLEIF API v1 (gleif.org)",
  "timestamp": "2026-06-24T12:00:00Z",
  "disclaimer": "Indicative data from the GLEIF register, not a compliance opinion.",
  "legal_name": "Ubisecure Oy",
  "jurisdiction": "FI",
  "managing_lou": "529900T8BM49AURSDO55",
  "entity_status": "ACTIVE",
  "legal_address": {
   "city": "ESPOO",
   "lines": [
    "Tekniikantie 14"
   ],
   "region": "FI-18",
   "country": "FI",
   "postal_code": "02150"
  },
  "legal_form_code": "DKUW",
  "last_update_date": "2024-06-20T07:11:02Z",
  "next_renewal_date": "2027-06-28T18:34:06Z",
  "registration_status": "ISSUED",
  "initial_registration_date": "2016-08-04T11:00:36Z"
 }
}
```

## More

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