GLEIF LEI Scraper

Search and extract legal entity data from the GLEIF (Global LEI Foundation) database — the authoritative global register of Legal Entity Identifiers (LEIs). Covers 2M+ entities across 200+ countries. Completely free, no authentication required.

Data Source

This actor uses the GLEIF API, a publicly available REST API provided by the Global Legal Entity Identifier Foundation. No API key or registration is required.

Features

• Search entities by company name or keyword across 2M+ global legal entities
• Fetch by LEI code — look up specific entities using their 20-character LEI
• Filter by status — ISSUED (active), LAPSED, RETIRED, ANNULLED, and more
• Filter by country — narrow results to a specific country using ISO 2-letter code
• Structured output with LEI, entity name, type, jurisdiction, address, registration dates
• Fully free — no API key, no proxy, no cookies

Input

Field	Type	Description
mode	String (required)	search or getByLEI
query	String	Company name or keyword (mode=search)
leiCodes	String[]	List of 20-char LEI codes (mode=getByLEI)
filterStatus	String	Filter by registration status (e.g. ISSUED, LAPSED)
filterCountry	String	2-letter ISO country code filter (e.g. US, DE, GB)
maxItems	Integer	Max records to return (1–1000, default: 50)

Example Input — Search

{
  "mode": "search",
  "query": "apple",
  "filterCountry": "US",
  "filterStatus": "ISSUED",
  "maxItems": 10
}

Example Input — Get by LEI

{
  "mode": "getByLEI",
  "leiCodes": ["HWUPKR0MPOU8FGXBT394"],
  "maxItems": 10
}

Output

Each record contains:

Field	Description
lei	20-character Legal Entity Identifier
entityName	Official legal name of the entity
entityType	Entity category (GENERAL, FUND, SOLE_PROPRIETOR, etc.)
jurisdiction	Jurisdiction code (e.g. US-CA, GB, DE)
country	2-letter ISO country code
city	City of legal address
postalCode	Postal code of legal address
addressLine1	First line of legal address
status	Registration status (ISSUED, LAPSED, RETIRED, etc.)
initialRegistrationDate	Date entity was first registered (YYYY-MM-DD)
lastUpdated	Date record was last updated (YYYY-MM-DD)
managingLOUName	Name of the LEI issuing organization
sourceUrl	GLEIF search record URL
recordType	Always entity
scrapedAt	ISO 8601 timestamp

Example Output

{
  "lei": "HWUPKR0MPOU8FGXBT394",
  "entityName": "Apple Inc.",
  "entityType": "GENERAL",
  "jurisdiction": "US-CA",
  "country": "US",
  "city": "Cupertino",
  "postalCode": "95014",
  "addressLine1": "One Apple Park Way",
  "status": "ISSUED",
  "initialRegistrationDate": "2012-06-06",
  "lastUpdated": "2025-10-01",
  "managingLOUName": "Bloomberg Finance L.P.",
  "sourceUrl": "https://search.gleif.org/#/record/HWUPKR0MPOU8FGXBT394",
  "recordType": "entity",
  "scrapedAt": "2026-05-30T10:00:00+00:00"
}

Use Cases

• KYC / AML compliance — verify legal entity identity and registration status
• Business intelligence — research companies by jurisdiction, country, or name
• Financial data enrichment — link counterparties to their official LEI records
• Regulatory reporting — identify and validate LEI codes for trading entities
• Due diligence — check entity registration history and managing LOU

FAQ

What is a LEI (Legal Entity Identifier)? A LEI is a 20-character alphanumeric code that uniquely identifies legal entities participating in financial transactions. It is mandated by financial regulators in many jurisdictions.

Is an API key required? No. The GLEIF API is publicly accessible with no registration or authentication.

What does ISSUED vs LAPSED status mean? ISSUED means the entity's LEI registration is current and valid. LAPSED means the registration has expired (not renewed). The entity may still be active — only the LEI renewal has lapsed.

How many entities are in GLEIF? The GLEIF database contains 2M+ legal entities from 200+ countries, primarily financial institutions, banks, funds, and corporates.

What is a Managing LOU? The Local Operating Unit (LOU) is the organization authorized to issue and manage LEIs in a jurisdiction. Examples include Bloomberg, DTCC, and London Stock Exchange Group.