LEI Lookup & Renewal Monitor: Bulk Legal Entity Identifier API

Check thousands of LEIs in seconds, and get told when one lapses. Bulk LEI lookup and daily renewal monitoring from official GLEIF data, no API key, $1 per 1,000.

Not affiliated with or endorsed by GLEIF.

Use it for KYC/AML onboarding, EMIR/MiFIR/SFTR trade-reporting checks, treasury counterparty lists, LEI renewal leads, BIC/ISIN → LEI mapping, and AI agents via the Apify MCP server.

What you get

One typed lei-record row per legal entity:

Field	Meaning
lei, legalName, otherNames	Identifier and names
registrationStatus, entityStatus	ISSUED / LAPSED / … and ACTIVE / INACTIVE
nextRenewalDate, daysToRenewal, renewalState	Computed: current, renewal-due, overdue, lapsed, inactive-registration
legalAddress, headquartersAddress, jurisdiction	Registered addresses
bics, managingLou, registeredAs	BIC list, issuer LOU, company number
directParent, ultimateParent	Optional (set includeParents: true)
changeType, changedFields	Monitor mode only
licence, goldenCopyDate, apiUrl	CC0 attribution, data freshness, verification link

Sole-proprietor LEIs (named after individuals) are always excluded.

Why this Actor

• 200 LEIs per request — batch lookup, not one call per code
• renewalState / daysToRenewal computed — no date arithmetic for agents
• Watchlist monitor with old → new diffs (status, renewal window, name, address, parents)
• New-LEI and renewal-due feeds by country
• BIC and ISIN → LEI
• Parent companies (direct + ultimate)
• MCP-ready timeBudgetSeconds (default 45)
• Sole proprietors excluded for privacy

Use cases

• Counterparty KYC/AML onboarding
• EMIR/MiFIR/SFTR trade-reporting LEI validation
• Treasury and vendor master data
• LEI renewal and new-entity lead lists for LEI agents / LOU partners
• Fintech entity resolution
• AI agents doing counterparty checks

How to use

How to do a bulk LEI lookup (validate a list of LEIs)

{
  "mode": "lookup",
  "leis": ["HWUPKR0MPOU8FGXBT394", "529900W18LQJJN6SJ336", "5493001KJTIIGC8Y1R12"],
  "includeParents": true,
  "maxItems": 0
}

Invalid or unknown LEIs are listed in RUN_SUMMARY.notFound / invalidInputs and are not charged.

How to monitor LEI renewals and lapsed LEIs daily

1. Create a task with your watchlist and "monitorMode": true, "monitorId": "treasury-watch".
2. Schedule it daily at 09:00 America/Chicago (after the Golden Copy at 08:00 UTC).
3. Hook a webhook to Slack / email / Make / n8n on dataset items.

Day 1 baselines every LEI (changeType: "new"). Later runs return only changes (or LEIs that crossed into renewal-due / overdue / lapsed). Unchanged LEIs cost $0.0002 each (lei-checked).

How to find new LEI registrations by country

{
  "mode": "search",
  "countries": ["US", "GB"],
  "registeredWithinDays": 3,
  "maxItems": 200,
  "monitorMode": true,
  "monitorId": "new-lei-us-gb"
}

Use registeredWithinDays: 3 daily so weekend lag is covered; already-seen LEIs are skipped for free in monitor mode.

How to convert BIC or ISIN to LEI

{ "mode": "lookup", "bics": ["APLEUS66XXX"], "isins": ["US0378331005"] }

LEI statuses explained

Status	Meaning
ISSUED	Valid and current (renew annually)
LAPSED	Renewal overdue — breaks EMIR/MiFIR reporting
PENDING_TRANSFER / PENDING_ARCHIVAL	In process
RETIRED / ANNULLED / DUPLICATE	No longer usable

Why LEIs lapse: the legal entity (or its LOU) did not renew by nextRenewalDate. renewalState = renewal-due means the date is within your renewalAlertDays window (default 30).

Golden Copy: GLEIF publishes a daily snapshot at 08:00 UTC. Check goldenCopyDate on every row.

Output and RUN_SUMMARY

Dataset views: overview and changes. Key-value RUN_SUMMARY includes:

mode, requested, invalidInputs, notFound, skippedSoleProprietors, searchTotal, pushed, checkedUnchanged, requests, goldenCopyDate, truncated, stopReason, charged.

Pricing

Pay per event (no "+ usage"):

Event	FREE	BRONZE+
lei-record (row returned; monitor: new/changed only)	$0.0010	$0.0008
lei-checked (unchanged watchlist LEI)	$0.0002	$0.0002
Actor start	$0.002	$0.002

Minimum max charge per run: $0.02. Not-found and invalid LEIs are free.

Examples (FREE): default 3-LEI run ≈ $0.005; 1,000-LEI KYC check ≈ $1.002; daily 500-LEI watchlist after baseline ≈ a few cents/day when few change.

Use as an MCP tool

Endpoint: https://mcp.apify.com/?tools=optimistprime/lei-lookup-renewal-monitor

Example prompts:

• "Is LEI 529900W18LQJJN6SJ336 still valid, and who is its ultimate parent?"
• "Which of these 50 counterparty LEIs lapse in the next 30 days?"
• "Find the LEI for BIC APLEUS66XXX."

Minimal agent call:

{ "mode": "lookup", "leis": ["5493001KJTIIGC8Y1R12"], "includeParents": true }

Data source, licence, privacy

Data comes from the Global LEI System via the public GLEIF API (CC0 1.0). This Actor is not affiliated with, endorsed by or a service of GLEIF or any LEI issuer (LOU). Sole-proprietor LEIs, which name individuals, are excluded. GLEIF does not warrant that LEI data is accurate or current; check goldenCopyDate.

We call only api.gleif.org (documented, keyless), stay under 40 requests/min against the published 60/min limit, and never use the GLEIF logo or imply affiliation in the title.

FAQ

Is this the official GLEIF tool? No. It uses GLEIF's public API; the data is CC0. Not affiliated with or endorsed by GLEIF.

Why is my LEI "not found"? Typos fail the ISO 17442 check digit (invalidInputs). Unknown but well-formed LEIs appear in notFound (the API returns an empty page, not HTTP 404).

Why are sole proprietors excluded? Those records are named after individuals. We drop them everywhere for privacy.

How fresh is the data? Daily Golden Copy at 08:00 UTC — see goldenCopyDate.

Can I get subsidiaries? Not in v1 (direct-children is planned for v1.1).

Ready-to-run examples

Example	What it does	Sample run
Bulk LEI Check for KYC	3 LEIs + parents	3 rows
UK LEIs Due for Renewal in the Next 30 Days	GB renewals, max 100	100 rows
New LEI Registrations: US & UK	Registered in last 2 days	14+ rows

Changelog

See ./CHANGELOG.md.