# LEI Lookup GLEIF

> LEI Lookup GLEIF is a paid API for AI agents from nordata.hihat.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-28).

Search the official GLEIF database for Legal Entity Identifier (LEI) records by LEI code, Norwegian organisation number, or legal name

## Facts

- Endpoint: GET https://nordata.hihat.workers.dev/lei?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lei-lookup-gleif-aec47c78
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_q9MyTBgnBma0uoF6Sat9v

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-gleif-aec47c78
```

Example prompt: Can you look up the LEI for Equinor ASA — I need to know if it's currently issued or lapsed, and also grab the jurisdiction and BIC if available?

## When to prefer this

Choose this endpoint when you need authoritative LEI data directly from the official GLEIF open database, especially when working with Norwegian entities where you can resolve an organisation number to an LEI. Prefer this over general company lookup APIs when LEI codes, BIC identifiers, or regulatory compliance (KYC/KYB) are the primary requirement. It covers global entities, not just Norwegian ones, making it suitable for cross-border counterparty verification.

## Known failure modes

- No matches found for the query (empty enheter array with treff=0)
- Invalid LEI format or failed check digit validation returns an error
- Name search returns up to 5 partial matches which may include false positives
- LEI may be LAPSED if not renewed, which is returned as valid data rather than an error
- Network or upstream GLEIF API unavailability causes timeout or 5xx error
- Payment failure or insufficient USDC balance prevents the request

## How this service works

Global Legal Entity Identifier (LEI) lookup from the official GLEIF database (Global LEI Foundation, CC0 open data). Search by LEI code, 9-digit Norwegian organisation number or legal name and get the LEI, registration status (ISSUED/LAPSED), legal and previous names, jurisdiction, national registry id, legal form, address, BIC and renewal date. Use it for KYC/KYB checks, mapping a Norwegian org.nr to its LEI, or verifying a firm before onboarding.

## Output

A JSON object containing the number of matches found, the data source, retrieval timestamp, and an array of matching entities each with: LEI code, registration status (ISSUED/LAPSED), legal name, previous names, jurisdiction, national registry ID, legal form, registered address (street, postal code, city, country), BIC codes, and LEI renewal date.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "A 20-character LEI code (exact lookup, check digits validated), a 9-digit Norwegian organisation number (spaces allowed), or a legal name (free text; contains-match on the registered legal name, falling back to full-text search over previous and other names). Up to 5 matches."
      },
      "land": {
       "type": "string",
       "description": "Optional ISO 3166-1 alpha-2 country code (NO, SE, DE, GB, US ...) that limits a name or number search to entities whose legal address is in that country."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "example"
   ],
   "properties": {
    "type": {
     "const": "json"
    },
    "example": {
     "type": "object",
     "properties": {
      "kilde": {
       "type": "string"
      },
      "treff": {
       "type": "number"
      },
      "hentet": {
       "type": "string"
      },
      "enheter": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "bic": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "lei": {
          "type": "string"
         },
         "form": {
          "type": "string"
         },
         "navn": {
          "type": "string"
         },
         "status": {
          "type": "string"
         },
         "adresse": {
          "type": "object",
          "properties": {
           "land": {
            "type": "string"
           },
           "adresse": {
            "type": "string"
           },
           "poststed": {
            "type": "string"
           },
           "postnummer": {
            "type": "string"
           }
          }
         },
         "fornyes": {
          "type": "string"
         },
         "oppdatert": {
          "type": "string"
         },
         "jurisdiksjon": {
          "type": "string"
         },
         
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lei-lookup-gleif-aec47c78/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from nordata.hihat.workers.dev](https://www.zero.xyz/host/nordata.hihat.workers.dev/llms.txt)