# GLEIF LEI Lookup by Company Name

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

Searches the GLEIF golden copy for a legal entity's LEI and full registration record by company name or exact LEI, including lapsed/retired/annulled entities for KYC and compliance use.

## Facts

- Endpoint: GET https://x402.donnyautomation.com/lei?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gleif-lei-lookup-by-company-name-e29b2829
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sQXoXc4tnYTRfzX1qNGGu

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-by-company-name-e29b2829
```

Example prompt: Can you look up the LEI for 'BlackRock Advisors, LLC' in the GLEIF registry and tell me its legal form, jurisdiction, registered address, and whether its LEI status is active or lapsed?

## When to prefer this

Prefer this endpoint when you need to resolve a company name to its LEI or retrieve full GLEIF registration data without already knowing the LEI — most GLEIF APIs require the LEI as input, making the name-to-LEI search step the critical bottleneck this endpoint solves. It is especially suited for KYC, AML, and compliance agents that need to verify counterparty legal identity, check entity status (including lapsed or retired records), and retrieve legal form, jurisdiction, and address data from the authoritative GLEIF golden copy. Choose it over general company data APIs when regulatory-grade LEI data and explicit lapse status are required.

## Known failure modes

- No match found for the searched company name — ambiguous or abbreviated names may return zero results; include the legal suffix (e.g. 'Inc.', 'Ltd.') for precision
- Multiple matches returned when a common name is searched — caller should narrow query or use the exact LEI parameter instead
- Invalid or malformed LEI provided to the lei parameter — must be exactly 20 alphanumeric characters
- Rate limit or payment failure (x402 protocol) — call rejected if USDC micropayment is not successfully processed
- GLEIF golden copy may have a propagation lag — very recently registered or updated LEIs may not appear immediately

## How this service works

Pay-per-call (x402/USDC on Base) market-data, geocoding, randomness and hook-risk endpoints. Free demo route included.

## Output

Returns a list of matching legal entities (up to the requested limit), each containing: the 20-character LEI, registered legal name, any previous names, legal form, jurisdiction, legal address, headquarters address, full registration record, and a lapsed flag indicating whether the LEI status is LAPSED, RETIRED, or ANNULLED rather than active.

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Legal entity name, max 200 chars. Include the suffix for a precise match, e.g. \"Apple Inc.\" rather than \"Apple\"."
      },
      "lei": {
       "type": "string",
       "description": "Exact 20-character LEI for a single record. Use instead of q."
      },
      "limit": {
       "type": "string",
       "description": "Maximum name-search results, 1..50 (default 10)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ts": "2026-08-03T00:00:00.000Z",
  "count": 1,
  "query": "Apple Inc.",
  "records": [
   {
    "lei": "HWUPKR0MPOU8FGXBT394",
    "lapsed": false,
    "status": "ACTIVE",
    "legalName": "APPLE INC.",
    "jurisdiction": "US-CA",
    "legalAddress": {
     "city": "CUPERTINO",
     "country": "US",
     "postalCode": "95014"
    },
    "registration": {
     "status": "ISSUED",
     "nextRenewalDate": "2027-03-08T17:27:20Z"
    }
   }
  ],
  "attribution": "LEI data from the GLEIF Golden Copy (CC0 1.0).",
  "totalMatches": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gleif-lei-lookup-by-company-name-e29b2829/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.donnyautomation.com](https://www.zero.xyz/host/x402.donnyautomation.com/llms.txt)