# GLEIF LEI Entity Search

> GLEIF LEI Entity Search is a paid API for AI agents from apiacre.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Search the GLEIF Global LEI Index by exact LEI code or legal name to retrieve ranked legal entity identity, registration, mapped-identifier, and relationship-availability evidence.

## Facts

- Endpoint: POST https://apiacre.com/v1/research/lei-entity-search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gleif-lei-entity-search-37c1bfea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EL7gsJQVl2CfN3cNuYl0e

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-entity-search-37c1bfea -d '<json body>'
```

Example prompt: Can you search the GLEIF LEI index for 'Deutsche Bank AG' and give me their LEI code, registration status, and any relationship or mapped-identifier data?

## When to prefer this

Choose this endpoint when you need authoritative, GLEIF-sourced legal entity identification — especially for financial compliance, KYC/KYB workflows, counterparty validation, or regulatory reporting. It is preferable over generic company search APIs when you need LEI codes specifically, registration status, mapped financial identifiers (BIC/ISIN), or parent-entity relationship flags backed by the official global LEI registry.

## Known failure modes

- No matching entity found for the provided name or LEI — returns empty results
- LEI code format invalid or malformed — returns validation error
- GLEIF index temporarily unavailable — upstream timeout or 5xx error
- Ambiguous legal name matches multiple entities — returns multiple ranked candidates requiring disambiguation
- Rate limit exceeded or payment failure — returns 402 or 429 error

## How this service works

Search the official GLEIF Global LEI Index by exact LEI or legal name and return ranked legal-entity identity, registration, mapped-identifier, and relationship-availability evidence.

## Output

Returns ranked results from the GLEIF Global LEI Index including legal entity identity fields (legal name, jurisdiction, entity status), LEI registration metadata (registration status, initial/last update dates), mapped identifiers (BIC, ISIN linkages), and flags indicating availability of relationship (parent/child) data. Results are ordered by relevance to the input query.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lei": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "legal_name": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "max_results": {
   "type": "integer"
  },
  "country_code": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "query": {
    "mode": "legal_name",
    "value": "Apple Inc.",
    "maxResults": 3,
    "countryCode": "US"
   },
   "source": "https://api.gleif.org/api/v1/lei-records",
   "status": "matched",
   "license": {
    "id": "CC0-1.0",
    "url": "https://creativecommons.org/publicdomain/zero/1.0/",
    "termsUrl": "https://www.gleif.org/en/meta/lei-data-terms-of-use/"
   },
   "matches": [
    {
     "lei": "HWUPKR0MPOU8FGXBT394",
     "match": {
      "type": "exact",
      "score": 1
     },
     "legalName": "Apple Inc.",
     "otherNames": [
      {
       "name": "Apple Computer, Inc.",
       "type": "PREVIOUS_LEGAL_NAME",
       "language": "en"
      }
     ],
     "legalAddress": {
      "city": "Glendale",
      "region": "US-CA",
      "country": "US",
      "postalCode": "91203",
      "addressLines": [
       "C/O C T Corporation System",
       "330 N. Brand Blvd"
      ]
     }
    }
   ],
   "disclaimer": "Official public LEI reference data normalized from GLEIF. Corroborate name ma...",
   "matchCount": 1,
   "limitations": [
    "Name-match scores rank candidates but do not establish identity.",
    "Not every legal entity has an LEI, and source records may be stale or incompl...",
    "Relationship flags indicate available GLEIF links; they do not expand the rel..."
   ],
   "retrievedAt": "2026-08-11T08:30:00+00:00",
   "totalCandidates": 20,
   "goldenCopyPublishedAt": "2026-08-11T00:00:00Z"
  },
  "meta": {
   "cached": false,
   "sources": [],
   "warnings": [],
   "duration_ms": 42,
   "next_actions": [
    {
     "path": "/v1/research/organization-evidence",
     "title": "Official supplier evidence report",
     "method": "POST",
     "reason": "Expand a selected GLEIF candidate with independent USAspending, SEC filing-ac...",
     "service": "research.organization-evidence"
    }
   ]
  },
  "service": "research.lei-entity-search",
  "version": "1",
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gleif-lei-entity-search-37c1bfea/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apiacre.com](https://www.zero.xyz/host/apiacre.com/llms.txt)