The GLEIF API is free and requires no API key or registration; send requests to https://api.gleif.org/api/v1/
Search by legal entity name with GET /api/v1/lei-records?filter[entity.legalName]={name} (URL-encode the name); results are paginated using JSON:API pagination conventions with page[number] and page[size] parameters
Look up a known LEI directly with GET /api/v1/lei-records/{lei} to retrieve the full record including entity.status (ACTIVE, INACTIVE, ANNULLED), entity.legalAddress, and entity.registrationAuthority details
Follow relationship links in the response to retrieve the entity's direct parent (GET /api/v1/lei-records/{lei}/direct-parent) and ultimate parent for corporate hierarchy mapping
Use the registration.nextRenewalDate field to detect lapsed LEIs; an LAPSED status means the entity may still exist but has not renewed, which is a KYC/KYB red flag
Known gotchas
A single GLEIF API request returns up to 200 records; implement pagination for broad name searches to retrieve the full result set
Entity names stored in GLEIF are in the legal registration language and character set; transliterated name searches may miss records — combine with BIC code or registration number filtering when available
LAPSED LEIs indicate non-renewal, not necessarily corporate dissolution; corroborate with the relevant national business registry before making a compliance determination
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp