# finanz.halowerk.com LEI Resolve

> finanz.halowerk.com LEI Resolve is a paid API for AI agents from finanz.halowerk.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Bidirectional LEI resolver: converts a 20-character LEI code to entity details, or resolves a company name to ranked matching entities with legal, registration, and status information.

## Facts

- Endpoint: POST https://finanz.halowerk.com/v1/lei-resolve
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/finanz-halowerk-com-lei-resolve-030afae4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xUEPBZHqN9higLNFJD2sY

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 finanz-halowerk-com-lei-resolve-030afae4 -d '<json body>'
```

Example prompt: Can you look up the LEI code 5493001KJTIIGC8Y1R12 and tell me the company's registered legal name, jurisdiction, address, and whether the LEI registration is still active?

## When to prefer this

Choose this endpoint when you need authoritative legal entity data tied to LEI codes — especially for financial compliance, KYC, counterparty verification, or regulatory reporting workflows. It is uniquely useful because it resolves in both directions (LEI-to-entity and name-to-LEI) and explicitly surfaces lapsed registration status rather than silently returning stale data. Prefer it over general company search tools when LEI codes are involved or when you need legally registered addresses and jurisdictions from an official GLEIF-backed source.

## Known failure modes

- Invalid or malformed 20-character LEI returns an error or empty result
- Company name with no GLEIF matches returns an empty results array
- Lapsed LEI registration is returned but flagged — data may be outdated
- Ambiguous company name returns many low-confidence matches requiring disambiguation
- Network or upstream GLEIF API timeout causes delayed or failed response

## How this service works

Resolves in both directions: a 20-character LEI returns that entity, a company name returns the matching entities ranked by the search. Each result carries the registered legal name, legal form, jurisdiction, registered address, the local register and registration number, and the LEI registration status with its last update and next renewal date — a lapsed registration means nobody renewed it and the data may be stale, which is stated rather than left to be discovered.

## Output

Returns one or more legal entity records, each containing: registered legal name, legal form, jurisdiction, registered address, local business register name and registration number, LEI code, registration status (e.g. ISSUED, LAPSED, PENDING_TRANSFER), last update timestamp, and next renewal date. If the input was a company name, results are ranked by relevance. A lapsed status is explicitly flagged to indicate potentially stale data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lei": {
   "type": "string",
   "maxLength": 20,
   "minLength": 20,
   "description": "A 20-character LEI. Either this or name."
  },
  "name": {
   "type": "string",
   "maxLength": 200,
   "minLength": 2,
   "description": "Company name to search for. Either this or lei."
  },
  "limit": {
   "type": "integer",
   "default": 5,
   "maximum": 20,
   "minimum": 1,
   "description": "How many results for a name search."
  },
  "country": {
   "type": "string",
   "maxLength": 2,
   "minLength": 2,
   "description": "Restrict a name search to this ISO country code."
  },
  "include_parents": {
   "type": "boolean",
   "default": true,
   "description": "Also fetch the direct and ultimate parent."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/finanz-halowerk-com-lei-resolve-030afae4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from finanz.halowerk.com](https://www.zero.xyz/host/finanz.halowerk.com/llms.txt)