# GLEIF Entity Resolver

> GLEIF Entity Resolver is a paid API for AI agents from gleif-entity.xplowdiaka.workers.dev, paid per call via x402, $0.015/call, status unknown (last checked 2026-09-14).

Resolves a company name to its LEI, legal details, jurisdiction, registration status, and corporate hierarchy using GLEIF open data with fuzzy-match confidence scoring.

## Facts

- Endpoint: POST https://gleif-entity.xplowdiaka.workers.dev/entity
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gleif-entity-resolver-e542a670
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_a0ya_ELjdTuv-YJx1bpXW

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-entity-resolver-e542a670 -d '<json body>'
```

Example prompt: Can you look up the LEI, jurisdiction, registration status, and any known subsidiaries for 'Apple Inc.' from the GLEIF registry and tell me how confident the name match is?

## When to prefer this

Use this endpoint when you need to resolve a company name to a canonical LEI and retrieve official GLEIF registry data — including jurisdiction, legal status, and corporate hierarchy — in a single call. Prefer it over manual GLEIF API queries when you need fuzzy name matching with a confidence score included. Ideal for KYC enrichment, compliance workflows, financial data pipelines, or any agent task requiring authoritative legal entity identification from open GLEIF data.

## Known failure modes

- Company name not found in GLEIF registry — returns empty or low-confidence result
- Ambiguous name matches multiple entities — confidence score will be low and candidates array populated
- LEI hierarchy data unavailable for some entities — parent/children fields may be null
- Rate limit or payment failure (x402) — request blocked
- Non-Latin or heavily abbreviated company names may reduce fuzzy-match accuracy

## How this service works

Resolve a company name to its canonical LEI: legal name, status, jurisdiction, address, registration status, and corporate hierarchy (parent + children) in one call, with a fuzzy-match confidence score. Data: GLEIF (CC0). Ask by legal or common company name.

## Output

Returns a JSON object with the matched company's LEI, legal name, entity status (e.g. ACTIVE), jurisdiction, address, registration status, initial registration date, direct parent LEI, ultimate parent LEI, a list of direct children (with LEIs and names), a list of fuzzy-match candidates, a confidence score (0–1), and a data disclaimer noting GLEIF CC0 provenance.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gleif-entity-resolver-e542a670/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gleif-entity.xplowdiaka.workers.dev](https://www.zero.xyz/host/gleif-entity.xplowdiaka.workers.dev/llms.txt)
