# GLEIF Legal Entity Identifier (LEI) Lookup

> GLEIF Legal Entity Identifier (LEI) Lookup is a paid API for AI agents from handel.halowerk.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-10).

Looks up a legal entity by LEI code or name in the GLEIF worldwide LEI register, resolving raw GLEIF codes (legal form, register) into human-readable labels with official names and register website links.

## Facts

- Endpoint: POST https://handel.halowerk.com/v1/registry-snapshot?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gleif-legal-entity-identifier-lei-lookup-f0ed15b3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wqByeAUWi6lHWTD26xO0S

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-legal-entity-identifier-lei-lookup-f0ed15b3 -d '<json body>'
```

Example prompt: Can you look up the legal entity details for LEI 5299000J2N45DDNE4Y07 in the GLEIF register and tell me the company's legal form and which registration authority it belongs to, with the register's website?

## When to prefer this

Choose this endpoint when you need human-readable GLEIF legal entity data and cannot handle raw GLEIF code values like legal form codes or RA register codes yourself. It is especially valuable for KYC, compliance, trade finance, or onboarding workflows where decoded legal form and register authority with a website link are required, not just raw JSON from GLEIF.

## Known failure modes

- LEI not found in GLEIF register — returns not-found response
- Ambiguous or unmatched company name search — may return multiple candidates or no match
- GLEIF code list lookup failure — legal form or register code cannot be resolved
- Invalid LEI format — malformed input rejected
- GLEIF API upstream unavailability — service temporarily unreachable

## How this service works

Looks up a legal entity in GLEIF, the worldwide Legal Entity Identifier register, by LEI or by name, and turns the raw record into an answer. GLEIF returns keys rather than statements: the legal form arrives as a code like 6QQB and the register as RA000304, so both are resolved against the GLEIF code lists into the legal form in its own language and the competent register with its website.

## Output

Returns a structured answer containing the legal entity's name, LEI, decoded legal form in its own language (not a raw code), jurisdiction, registered address, the name of the competent registration authority (resolved from RA code), and a link to the register's website.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lei": {
   "type": "string",
   "pattern": "^[A-Z0-9]{20}$",
   "description": "Legal Entity Identifier, 20 characters. The precise route."
  },
  "name": {
   "type": "string",
   "maxLength": 200,
   "minLength": 2,
   "description": "Legal name to search for, when the LEI is unknown."
  },
  "country": {
   "type": "string",
   "pattern": "^[A-Za-z]{2}$",
   "description": "ISO country code narrowing a name search, for example DE."
  },
  "include_relationships": {
   "type": "boolean",
   "default": true,
   "description": "Also resolve ultimate parent and direct subsidiaries."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gleif-legal-entity-identifier-lei-lookup-f0ed15b3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from handel.halowerk.com](https://www.zero.xyz/host/handel.halowerk.com/llms.txt)