# LEI Lookup API

> LEI Lookup API is a paid API for AI agents from ai-data-marketplace-1042299154756.us-central1.run.app, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-13).

Looks up Legal Entity Identifier (LEI) records by exact LEI code or legal entity name, returning entity status and registration details.

## Facts

- Endpoint: GET https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/lei_lookup
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lei-lookup-api-fba8badb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iVO9MvIS77YhU30KIb_mO

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-lookup-api-fba8badb
```

Example prompt: Can you look up the LEI for Goldman Sachs and tell me if it's currently active?

## When to prefer this

Use this endpoint when you need to resolve or verify Legal Entity Identifiers (LEIs) as part of compliance, KYC, trade settlement, or due diligence workflows. It is ideal for agents that need to cross-reference a company name with its official GLEIF-registered LEI, or confirm entity status before a regulated transaction. Prefer this over general company lookup APIs when LEI-specific data (ISO 17442 standard) is required by regulatory frameworks such as MiFID II, EMIR, or Dodd-Frank.

## Known failure modes

- LEI not found — returns empty entities array with count 0
- Invalid LEI format (not 20 characters) — may return error or empty result
- Name search returns too many matches — use limit parameter to constrain results
- Network timeout or upstream GLEIF registry unavailability — service error response
- No query parameters provided — request may return error or empty result

## How this service works

Look up official Legal Entity Identifier records by LEI or legal name through the live GLEIF API.

## Output

Returns a JSON object with a success flag, a count of matched entities, and an array of entity records each containing the 20-character LEI code, the official registered legal name, and entity status (e.g. ACTIVE, INACTIVE, ANNULLED), plus any additional registration metadata available from the GLEIF registry.

## 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",
     "properties": {
      "lei": {
       "type": "string",
       "description": "Exact 20-character Legal Entity Identifier."
      },
      "name": {
       "type": "string",
       "description": "Legal entity name search when LEI is not supplied."
      },
      "limit": {
       "type": "integer",
       "description": "Maximum results from 1 to 10; defaults to 5."
      }
     },
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "success",
      "count",
      "entities"
     ],
     "properties": {
      "count": {
       "type": "integer"
      },
      "success": {
       "type": "boolean"
      },
      "entities": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "lei",
         "legal_name",
         "entity_status"
        ],
        "properties": {
         "lei": {
          "type": "string"
         },
         "legal_name": {
          "type": "string"
         },
         "entity_status": {
          "type": "string"
         }
        },
        "additionalProperties": true
       }
      }
     },
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "success": true,
  "entities": [
   {
    "lei": "...",
    "legal_name": "...",
    "entity_status": "ACTIVE"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lei-lookup-api-fba8badb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ai-data-marketplace-1042299154756.us-central1.run.app](https://www.zero.xyz/host/ai-data-marketplace-1042299154756.us-central1.run.app/llms.txt)