# GLEIF LEI Full Record Lookup

> GLEIF LEI Full Record Lookup is a paid API for AI agents from agent-toolbox.zafermemon87.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-30).

Returns the complete official GLEIF record for a legal entity identified by its 20-character LEI, including names, addresses, registration details, legal form, status, and parent relationships.

## Facts

- Endpoint: GET https://agent-toolbox.zafermemon87.workers.dev/v1/company/lei?utm_source=zero.xyz
- Price: $0.005/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-full-record-lookup-fe3c0763
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Xc34W5fZFuXQ_ydgPM6Ns

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-full-record-lookup-fe3c0763
```

Example prompt: Can you pull the full GLEIF record for the LEI HWUPKR0MPOU8FGXBT394 — I need the legal name, registered address, entity status, and any parent companies listed?

## When to prefer this

Use this endpoint when you have a specific LEI and need the complete official GLEIF record for that entity, including addresses, legal form, status, and corporate hierarchy. Prefer this over a name-search endpoint when the LEI is already known and you need authoritative, structured data for compliance, KYB, or corporate research purposes.

## Known failure modes

- Invalid or malformed LEI (not 20 characters) returns an error
- LEI not found in GLEIF registry returns a not-found error
- GLEIF upstream service unavailable causes a timeout or 5xx error
- LEI exists but entity has no parent data — direct_parent and ultimate_parent returned as null

## How this service works

Full official record of a legal entity by its LEI (Legal Entity Identifier) from GLEIF: legal and other names, registered and head-office addresses, company-register number, legal form, status, founding date, LEI status, and its direct and ultimate parent companies.

## Output

A JSON object containing the entity's LEI, legal name, any alternative names, BIC codes, entity status (e.g. ACTIVE), LEI status (e.g. ISSUED), legal form code, jurisdiction, founding date, company registration number, registered legal address, headquarters address, direct parent LEI (if any), ultimate parent LEI (if any), registration authority, last update date, and next renewal date. Also includes a human-readable plain-text summary.

## 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": [
      "lei"
     ],
     "properties": {
      "lei": {
       "type": "string",
       "description": "20-character LEI, e.g. HWUPKR0MPOU8FGXBT394"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "bic": [
   "APLEUS66XXX"
  ],
  "lei": "HWUPKR0MPOU8FGXBT394",
  "plain": "Apple Inc.: active (H1UM) in US-CA, registered as 806592; LEI issued.",
  "source": "GLEIF Global LEI Index (CC0)",
  "country": "US",
  "founded": "1977-01-03",
  "category": "GENERAL",
  "legal_form": "H1UM",
  "legal_name": "Apple Inc.",
  "lei_status": "ISSUED",
  "other_names": [
   "Apple Computer, Inc."
  ],
  "headquarters": {
   "city": "Cupertino",
   "lines": [
    "One Apple Park Way"
   ],
   "region": "US-CA",
   "country": "US",
   "postal_code": "95014"
  },
  "jurisdiction": "US-CA",
  "direct_parent": null,
  "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",
  "lei_last_update": "2026-03-03",
  "ultimate_parent": null,
  "lei_next_renewal": "2027-03-08",
  "registration_authority": "RA000598"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gleif-lei-full-record-lookup-fe3c0763/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-toolbox.zafermemon87.workers.dev](https://www.zero.xyz/host/agent-toolbox.zafermemon87.workers.dev/llms.txt)