# Eckari LEI Search > Eckari LEI Search is a paid API for AI agents from api.eckari.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-11). Search the global GLEIF register for Legal Entity Identifiers (LEIs) by company name, optionally filtered by country ## Facts - Endpoint: GET https://api.eckari.com/v1/entities/lei/search?utm_source=zero.xyz - Price: $0.003/call - Payment: x402 - Status: unknown - Last checked: 2026-10-11 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/eckari-lei-search-e6fbf3f0 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Z_5lkv51dA56Rw_HQRg4E 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 eckari-lei-search-e6fbf3f0 ``` Example prompt: Can you find the LEI for Tesco PLC in the UK? Search the GLEIF register and give me the LEI code, entity status, and local registry details. ## When to prefer this Use this endpoint when you need to look up a Legal Entity Identifier (LEI) by company name and have no LEI to start with. Ideal for KYC, AML, trade reporting compliance (MiFID II, EMIR, Dodd-Frank), and any workflow requiring the standardised 20-character ISO 17442 LEI. Prefer this over national company register lookups when you need a globally portable identifier rather than a local registration number. Use the country parameter to narrow results when searching common names that appear in multiple jurisdictions. ## Known failure modes - Query too short (under 2 characters) returns a validation error - Country code not a valid ISO 3166-1 alpha-2 format returns a validation error - Offset exceeds 9900 cap — GLEIF refuses deep pagination beyond 10,000 records - No entities match the name query — returns an empty items array - GLEIF upstream unavailable — service may return a 503 or degraded response - Limit exceeds 25 cap — capped automatically or returns a validation error ## How this service works Find Legal Entity Identifiers by company name in the global GLEIF register, optionally narrowed to one country. Returns the LEI, legal name, registration and entity status, jurisdiction, legal address and the local registry the entity is registered at — the identifier bridge between national company registers worldwide. Use when: What is the LEI for this company? ## Output Returns a paginated list of matching legal entities from the GLEIF register, each including the LEI code, official legal name, language of the name, entity status (ACTIVE/INACTIVE), LEI registration status (ISSUED/RETIRED/etc.), jurisdiction, full legal address (street lines, city, region, postal code, country), the company registration number at the local registry, and the name and GLEIF registry code of the local business registry. Also includes pagination metadata (total results, offset, limit, has_more flag, next_offset). ## 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", "required": [ "q" ], "properties": { "q": { "type": "string", "maxLength": 200, "minLength": 2, "description": "Legal entity name or name fragment. GLEIF applies its own matching to this value; Eckari does not re-rank the results." }, "limit": { "type": "integer", "default": 10, "maximum": 25, "minimum": 1, "description": "Maximum number of entities to return. Capped at 25 because that is the most records one fuzzy-completion fill-in pass can hydrate; a larger page could not be filled and would misreport how much GLEIF holds." }, "offset": { "type": "integer", "maximum": 9900, "minimum": 0, "description": "Zero-based offset into the result set for paging. Pass back page.next_offset from the previous response; page.has_more says whether there is one. GLEIF pages by page number, so an offset that is a multiple of limit is one upstream page - which is every offset page.next_offset produces. Capped at 9900 because GLEIF refuses page-based pagination beyond 10,000 records; beyond that, narrow the query." }, "country": { "type": "string", "pattern": "^[A-Za-z]{2}$", "description": "ISO 3166-1 alpha-2 country code of the entity's legal address, used to narrow the search (e.g. GB, US, DE)." } }, "additionalProperties": false } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object" } } } } } ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "data": { "page": { "limit": 3, "total": 11, "offset": 0, "has_more": true, "returned": 3, "next_offset": 3 }, "items": [ { "lei": "2138002P5RNKC5W2JZ46", "legal_name": "TESCO PLC", "jurisdiction": "GB", "match_source": "filter", "entity_status": "ACTIVE", "legal_address": { "city": "WELWYN GARDEN CITY", "lines": [ "TESCO HOUSE", "SHIRE PARK, KESTREL WAY" ], "region": "GB-HRT", "country": "GB", "postal_code": "AL7 1GA" }, "registered_as": "00445790", "registered_at": { "name": "Companies House", "ra_code": "RA000585" }, "legal_name_language": "en", "registration_status": "ISSUED" }, { "lei": "213800DJFYY7MSLDKD28", "legal_name": "TESCO TREASURY SERVICES PLC", "jurisdiction": "GB", "match_source": "filter", "entity_status": "INACTIVE", "legal_address": { "city": "WELWYN GARDEN CITY", "lines": [ "TESCO HOUSE", "SHIRE PARK, KESTREL WAY" ], "region": null, "country": "GB", "postal_code": "AL7 1GA" }, "registered_as": "07656305", "registered_at": { "name": "Companies House", "ra_code": "RA000585" }, "legal_name_language": "en", "registration_status": "RETIRED" }, { "lei": "JL5Y1BHW3R0NH5H6C288", "legal_name": "TESCO PLC PENSION SCHEME", "jurisdiction": "GB", "match_source": "filter", "entity_status": "ACTIVE", "legal_address": { "city": "WELWYN GARDEN CITY", "lines": [ "C/O TESCO PENSION TRUSTEES LIMITED", "TESCO HOUSE, SHIRE PARK, KESTREL WAY" ], "region": "GB-HRT", "country": "GB", "postal_code": "AL7 1GA" }, "registered_as": null, "registered_at": { "name": null, "ra_code": "RA999999" }, "legal_name_language": "en", "registration_status": "ISSUED" } ], "query": "TESCO PLC", "country": "GB" }, "meta": { "source": "gleif", "version": "2.1.0", "freshness": "near_live", "capability": "entity.lei.search" } } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eckari-lei-search-e6fbf3f0/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from api.eckari.com](https://www.zero.xyz/host/api.eckari.com/llms.txt)