# LEI Legal Entity Lookup

> LEI Legal Entity Lookup is a paid API for AI agents from data.japanagent.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-10).

Returns the GLEIF golden copy record for a legal entity given its 20-character LEI, including legal name, jurisdiction, addresses, and registration status.

## Facts

- Endpoint: GET https://data.japanagent.dev/corp/lei/:lei?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lei-legal-entity-lookup-b927beaa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xkzzMgSgI9C6ue6IdOIBr

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 lei-legal-entity-lookup-b927beaa
```

Example prompt: Can you look up the GLEIF record for the LEI 549300TRUWO2CD2G5692 and tell me the legal name, jurisdiction, and whether it's currently active?

## When to prefer this

Use this endpoint when you have a known 20-character LEI and need the authoritative GLEIF golden copy record. Prefer this over the company-name-search or company enrichment endpoints when you already have the LEI and want the fastest, most direct lookup. Ideal for KYB pipelines, compliance checks, and counterparty verification where the LEI is already known.

## Known failure modes

- Invalid LEI format (not 20 alphanumeric characters) — returns 400 or validation error
- LEI not found in GLEIF database — returns 404
- GLEIF upstream unavailable — returns 503 or timeout
- Payment not provided — returns 402 Payment Required

## How this service works

Look up any legal entity worldwide by its 20-character LEI (Legal Entity Identifier). Returns the GLEIF golden copy record: legal name, jurisdiction, addresses, registration status. Global KYB primitive.

## Output

Returns the GLEIF golden copy record for the requested LEI, including the entity's canonical legal name, jurisdiction, registered and headquarters addresses, and registration status (e.g. ISSUED, LAPSED, MERGED).

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lei-legal-entity-lookup-b927beaa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.japanagent.dev](https://www.zero.xyz/host/data.japanagent.dev/llms.txt)