# GLEIF LEI Registry Lookup

> GLEIF LEI Registry Lookup is a paid API for AI agents from data.greeneris.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Look up or search legal entities by LEI code or company name using the GLEIF golden copy LEI reference dataset

## Facts

- Endpoint: GET https://data.greeneris.io/v1/global/lei
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gleif-lei-registry-lookup-42245ee4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-bk2LXWaCk5XfqoG8Gi2w

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-registry-lookup-42245ee4
```

Example prompt: Can you look up the legal entity details for LEI code 529900FCMZ4LKXFD0R69 and tell me whether it's still active, who the registered entity is, and when it needs to be renewed?

## When to prefer this

Use this endpoint when you need authoritative legal entity identification data from the GLEIF global LEI registry — particularly for compliance, KYC, counterparty verification, or cross-border financial workflows. Prefer this over national registries (e.g. INSEE Sirene, Companies House) when you need a globally consistent identifier or when the entity may be domiciled outside a single country. Best for direct LEI resolution or name-based discovery across all jurisdictions.

## Known failure modes

- Invalid or malformed 20-character LEI returns empty result or 400 error
- Name search with no matches returns empty array
- Country code not recognized returns 400 or empty results
- Limit parameter out of range (outside 1-10) may return error
- Stale data possible within the 24-hour cache window
- Network timeout or upstream GLEIF unavailability returns 5xx

## How this service works

Legal entity reference data from the GLEIF LEI golden copy (updated daily, CC0). Direct lookup: ?lei=529900FCMZ4LKXFD0R69. Search: ?name=airbus&country=FR&limit=5. Each result: lei, legal_name, entity_status, registration_status (ISSUED/LAPSED), jurisdiction, legal_form_id, hq_city/country, next_renewal_date. 24h cache.

## Output

Returns an array of matching legal entities (up to the requested limit) each containing: LEI code, legal name, entity status (ACTIVE/INACTIVE), registration status (ISSUED/LAPSED), jurisdiction, legal form ID, HQ city and country, and next LEI renewal date. Data sourced from the GLEIF golden copy, updated daily under CC0 license, 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "lei": {
       "type": "string",
       "description": "20-character LEI code for a direct lookup"
      },
      "name": {
       "type": "string",
       "description": "Legal name to search (used when lei is absent)"
      },
      "limit": {
       "type": "integer",
       "default": 5,
       "description": "Max search results, 1-10"
      },
      "country": {
       "type": "string",
       "description": "2-letter legal-address country filter (optional)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": {
   "name": "airbus",
   "country": "FR"
  },
  "total": 15,
  "source": "GLEIF LEI Records API, golden copy (data licensed CC0)",
  "results": [
   {
    "lei": "529900FCMZ4LKXFD0R69",
    "hq_city": "BLAGNAC",
    "hq_country": "FR",
    "legal_name": "AIRBUS",
    "jurisdiction": "FR",
    "entity_status": "ACTIVE",
    "legal_form_id": "6CHY",
    "next_renewal_date": "2026-12-05T09:23:00Z",
    "registration_status": "ISSUED"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gleif-lei-registry-lookup-42245ee4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.greeneris.io](https://www.zero.xyz/host/data.greeneris.io/llms.txt)