# GLEIF Corporate LEI Registry Lookup

> GLEIF Corporate LEI Registry Lookup is a paid API for AI agents from api.fadeandco.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-28).

Search GLEIF's global Legal Entity Identifier database by legal name or look up an exact 20-character LEI, returning entity status, location, and registration details.

## Facts

- Endpoint: GET https://api.fadeandco.workers.dev/api/agent-intel/gleif-corporate-lei-registry?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gleif-corporate-lei-registry-lookup-f0b9fe60
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5cUm1_Xd7fMqS4YGA6eM4

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-corporate-lei-registry-lookup-f0b9fe60
```

Example prompt: Can you look up the LEI record for 'Apple Inc.' in the GLEIF database and tell me its LEI code, country, and whether its registration status is active?

## When to prefer this

Choose this endpoint when you need authoritative, globally recognized legal entity identification data from GLEIF's official registry — ideal for KYC/AML workflows, counterparty onboarding, financial compliance checks, or any scenario requiring verified corporate identity. Prefer this over general company data APIs when the LEI code itself or GLEIF registration status is specifically required. Note that parent company relationships are not expanded and require additional requests.

## Known failure modes

- Name query too short (under 3 characters) returns validation error
- No matching entities found returns empty records array
- Invalid or malformed 20-character LEI returns error or empty result
- GLEIF upstream API unavailable causes timeout or 5xx response
- Name query is ambiguous and returns up to 5 results which may not include the intended entity

## How this service works

Legal entity identifier (LEI) records from GLEIF's public database: search by legal name (up to 5 matches) or look up one 20-character LEI. Returns legal name, country, city, entity and registration status. Parent companies are not expanded here (a second request per entity would be needed).

## Output

Returns a JSON object with the query mode (name or LEI), the source GLEIF API URL used, a checkedAt timestamp, the total number of matches found, and an array of up to 5 matching records — each containing the 20-character LEI, legal name, city, country, entity status (e.g. ACTIVE), registration status (e.g. ISSUED or LAPSED), and last updated timestamp.

## 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": [],
     "properties": {
      "lei": {
       "type": "string",
       "description": "20-character LEI for an exact lookup"
      },
      "name": {
       "type": "string",
       "description": "Legal name to search, 3 to 100 characters (or leave out and use lei)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mode": "name",
  "source": "https://api.gleif.org/api/v1/lei-records?filter%5Bentity.legalName%5D=Apple%20Inc.&page%5Bsize%5D=5",
  "records": [
   {
    "lei": "HWUPKR0MPOU8FGXBT394",
    "city": "Glendale",
    "country": "US",
    "legalName": "Apple Inc.",
    "lastUpdated": "2026-03-03T16:34:33Z",
    "entityStatus": "ACTIVE",
    "registrationStatus": "ISSUED"
   },
   {
    "lei": "254900KZR24L5GN8TE52",
    "city": "WILMINGTON",
    "country": "US",
    "legalName": "Apple Ford, Inc.",
    "lastUpdated": "2022-03-15T11:45:58Z",
    "entityStatus": "ACTIVE",
    "registrationStatus": "LAPSED"
   }
  ],
  "checkedAt": "2026-10-23T09:35:22.835Z",
  "totalMatches": 24
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gleif-corporate-lei-registry-lookup-f0b9fe60/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.fadeandco.workers.dev](https://www.zero.xyz/host/api.fadeandco.workers.dev/llms.txt)
