# GLEIF LEI Legal Entity Lookup

> GLEIF LEI Legal Entity Lookup is a paid API for AI agents from project-api-gamma-sable.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Looks up legal entity identity information from the GLEIF database by LEI code or name, returning slim JSON with a UI link.

## Facts

- Endpoint: GET https://project-api-gamma-sable.vercel.app/paid/gleif/lei?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gleif-lei-legal-entity-lookup-37b2327a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ItA05U-mmWV3cDUnwMBU4

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-legal-entity-lookup-37b2327a
```

Example prompt: Can you look up the legal entity details for LEI code 7H6GLXDRUGQFU57RNE97 in the GLEIF database and tell me what company it belongs to?

## When to prefer this

Choose this endpoint when you need to look up legal entity identity from the authoritative GLEIF registry by LEI code or entity name, especially for compliance, KYC, or financial due diligence workflows. Prefer this over yente or other GLEIF wrappers when you want a slim JSON response with a direct UI link rather than full verbose GLEIF API output. Best suited for per-lookup use cases at $0.01/call rather than bulk batch processing.

## Known failure modes

- HTTP 402 if payment header is missing or invalid — request requires USDC payment on Base
- Empty items array if no entity matches the query or LEI
- Invalid LEI format may return no results
- Rate limiting or downstream GLEIF API unavailability may cause errors
- Missing required 'q', 'lei', or 'name' query parameter returns an error

## How this service works

Paid public-data feeds. Unpaid requests return HTTP 402. Prices are USDC on Base.

## Output

Returns a slim JSON object containing matched legal entity records from the GLEIF database, including entity name, LEI code, and a UI link to the full GLEIF record. The response also includes the source path and metadata. Empty items array if no match found.

## 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",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Free-text query"
      },
      "lei": {
       "type": "string",
       "description": "Financial institution LEI"
      },
      "name": {
       "type": "string",
       "description": "Facility name"
      },
      "limit": {
       "type": "string",
       "description": "Max results"
      },
      "query": {
       "type": "string",
       "description": "Search / SPARQL query"
      },
      "page_size": {
       "type": "string",
       "description": "Query param: page_size"
      },
      "page[size]": {
       "type": "string",
       "description": "Query param: page[size]"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "what": "GLEIF LEI legal-entity identity lookup (slim JSON + uiLink; ≠ yente)",
  "items": [],
  "source": "/paid/gleif/lei"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gleif-lei-legal-entity-lookup-37b2327a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from project-api-gamma-sable.vercel.app](https://www.zero.xyz/host/project-api-gamma-sable.vercel.app/llms.txt)