# GLEIF LEI Lookup via Axiom Works

> GLEIF LEI Lookup via Axiom Works is a paid API for AI agents from api.axiomworks.co.uk, paid per call via x402, $0.005/call, status down (last checked 2026-11-16).

Look up a Legal Entity Identifier (LEI) or search by company name/registration number to retrieve full entity details including parent relationships, addresses, BIC/mapped IDs, and status.

## Facts

- Endpoint: GET https://api.axiomworks.co.uk/lei?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: down
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gleif-lei-lookup-via-axiom-works-e7102d2a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_L6pUw6mQelJ2o-H__mEpD

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-lookup-via-axiom-works-e7102d2a
```

Example prompt: Can you look up the LEI HWUPKR0MPOU8FGXBT394 and tell me the company's legal name, its direct and ultimate parent entities, registered address, and current status?

## When to prefer this

Use this endpoint when you need authoritative LEI data for a known entity — especially when you need parent chain (direct + ultimate parent) alongside standard entity metadata. It's the lowest-cost entry point ($0.005) for single LEI lookups or best-match name/registration searches with CC0 open data. Prefer this over /lei-full when you only need one result without multiple name-match candidates. Best for compliance, KYB pre-screening, or enriching counterparty data with regulatory identifiers.

## Known failure modes

- LEI not found in GLEIF registry — 404 or empty result
- Invalid or malformed 20-character LEI code — validation error
- Name search returns no match or ambiguous result — empty or low-confidence response
- Parent entity not reported to GLEIF — parents fields return null
- Upstream GLEIF API unavailability — service error or timeout
- Payment not received — 402 Payment Required before data is returned

## How this service works

Use this for a GLEIF Legal Entity Identifier lookup (CC0, no key): lei / name / registered_as (+ optional country). ALWAYS returns parents.direct + parents.ultimate (null if unreported), BIC/mapped ids, legal/hq address, status, jurisdiction. Soft-cached 24h. Path alias /lei/{lei}. Upsell /lei-full $0.05 for up to 10 name matches each with parents. Example: {lei:"HWUPKR0MPOU8FGXBT394"}. $0.005. Related: Screen many name matches with parents: /lei-full $0.05 (up to 10); KYB pack: /kyb $2.50.

## Output

Returns a JSON object with the entity's LEI code, legal name, registration number, entity status, jurisdiction, legal and HQ addresses, BIC and other mapped IDs, direct parent LEI (or null if unreported), and ultimate parent LEI (or null if unreported). Results are soft-cached for 24 hours.

## 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",
     "anyOf": [
      {
       "required": [
        "lei"
       ]
      },
      {
       "required": [
        "name"
       ]
      },
      {
       "required": [
        "registered_as"
       ]
      }
     ],
     "properties": {
      "lei": {
       "type": "string",
       "description": "20-char Legal Entity Identifier, e.g. HWUPKR0MPOU8FGXBT394"
      },
      "name": {
       "type": "string",
       "description": "Legal name search (best match)"
      },
      "country": {
       "type": "string",
       "description": "Optional ISO2 with name/registered_as"
      },
      "registered_as": {
       "type": "string",
       "description": "National registration number"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gleif-lei-lookup-via-axiom-works-e7102d2a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.axiomworks.co.uk](https://www.zero.xyz/host/api.axiomworks.co.uk/llms.txt)
