entities_search
Search GLEIF Level-1 legal entities by identity or name.
Description
Search GLEIF Level-1 legal entities by identity or name.
The shared envelope returns echoed filters and ranked data.matches.
Every match includes the LEI join key, legal name, jurisdiction, status,
match reason, source, and as_of. Results are bounded to 1-50 and
use pagination.next_cursor. Use this for discovery, then call
entities_get for the profile or entities_get_ownership for Level-2
relationships. Example: query="Apple Computer", country="US".
bad_parameter reports blank input, invalid country, limit, or cursor;
unknown_entity means no held entity matched. GLEIF data is CC0.
Parameters
Input schema advertised to MCP clients and mirrored by the REST query string.
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| query | string | Yes | — | — | Case-insensitive legal name, alias, previous name, or exact 20-character LEI. Choose a returned LEI for entities_get or entities_get_ownership. |
| country | string | null | No | null | — | Optional 2-letter ISO country code for the GLEIF legal address, such as US or GB. |
| status | "ACTIVE" | "INACTIVE" | null | No | null | — | Optional current GLEIF entity status: ACTIVE or INACTIVE. |
| limit | integer | No | 10 | min 1, max 50 | Ranked matches per page (1-50). |
| cursor | string | null | No | null | — | Opaque cursor from pagination.next_cursor. Keep query, country, and status unchanged while paging; omit for the first page. |
Provenance
Sources behind every value this tool returns.
- gleifGlobal Legal Entity Identifier Foundation
Dataset registry: entities_gleif_level_one