GLEIF LEI Scraper

GLEIF LEI Scraper

Company identity data from the Global LEI Index (legal names, addresses, register numbers, legal forms and parent companies) as clean JSON.

The Global LEI Index lists almost 3.5 million legal entities that hold a Legal Entity Identifier (LEI), the 20-character code that banks, funds, listed companies and their subsidiaries need to trade and report to regulators. This Actor searches the index by company name, looks up LEI codes, or reads GLEIF record URLs, and returns each entity's legal and other names, registered and headquarters addresses, company register and register number, legal form, status, LEI renewal dates, BIC and other identifiers, and its direct and ultimate parent companies. Search a name, a list of LEIs, or a whole slice of the index by country, legal form and status. The data is the official GLEIF Golden Copy, published under CC0 and updated daily. There is no login, no API key and no proxy to set up. Built for KYC and onboarding teams, lead generation, supplier and counterparty checks, and corporate-structure research.

⚡ Quick start

{
  "searchTerms": ["Siemens"],
  "startUrls": [
    { "url": "https://search.gleif.org/#/record/W38RGI023J3WT1HWRP32" }
  ],
  "maxItems": 5
}

🧩 Input

Field	Type	Required	Default	Description
searchTerms	array	no	—	Company names to search for, such as Siemens. Matches legal, trading, previous and transliterated names, best matches first.
leis	array	no	—	LEI codes to fetch directly, such as W38RGI023J3WT1HWRP32. Invalid codes are skipped and listed in the log.
startUrls	array	no	—	GLEIF URLs: record pages (https://search.gleif.org/#/record/<LEI>) or search pages (…/#/search/simpleSearch=<name>). lei-lookup.com record URLs work too.
countries	array	no	—	Only entities whose legal address is in these countries (two-letter ISO codes, such as DE).
legalForms	array	no	—	Only entities with these ISO 20275 legal-form (ELF) codes, such as 6QQB (German AG) or 2HBR (German GmbH).
entityStatus	string	no	—	ACTIVE or INACTIVE. Leave empty for both.
registrationStatuses	array	no	—	Only LEIs in these registration states, such as ISSUED or LAPSED.
categories	array	no	—	Only these kinds of entity: GENERAL, FUND, BRANCH, SOLE_PROPRIETOR, RESIDENT_GOVERNMENT_ENTITY, INTERNATIONAL_ORGANIZATION.
includeRelationships	boolean	no	true	Include parents and subsidiaries: each entity's direct and ultimate parent (or why none is reported) and how many direct and ultimate subsidiaries hold an LEI.
maxItems	integer	no	—	Maximum entities per company name or search URL. The input form starts at 5; leave it empty to get every match. LEI codes and record URLs always return one entity each.
proxyConfiguration	object	no	{ "useApifyProxy": false }	Proxy settings. The Global LEI Index needs no proxy.

Give at least one company name, LEI code or GLEIF URL, or set a filter on its own: with filters and no names, the Actor lists every entity that matches them, for example every active German Aktiengesellschaft (countries: ["DE"], legalForms: ["6QQB"], entityStatus: "ACTIVE"). The filters apply to name searches and filter-only listings; LEI codes are always fetched as given.

📤 Output

Each legal entity is one dataset row. Dates are ISO 8601. Country and region codes are ISO 3166.

Fields

Field	Type	Description
lei	string	The Legal Entity Identifier.
legalName	string	Official legal name.
otherNames	array	Trading, previous and other names: name, language, type.
transliteratedNames	array	Latin-script versions of the names: name, language, type.
legalAddress	object	Registered address: addressLines, addressNumber, city, region, postalCode, country.
headquartersAddress	object	Headquarters address, same shape.
registeredAt	object	The company register: authorityId (GLEIF RA code), authorityName, authorityOrganization, and entityId, the entity's number there (e.g. company number).
legalJurisdiction	string	Jurisdiction of legal formation.
legalForm	object	code (ISO 20275 ELF code) and name.
category	string	GENERAL, FUND, BRANCH, SOLE_PROPRIETOR, and so on.
subCategory	string	Sub-category, when given.
status	string	Entity status: ACTIVE or INACTIVE.
creationDate	string	When the entity was legally created.
expiration	object	For an entity that has ceased: date and reason. Null otherwise.
associatedEntity	object	For a fund, its manager or umbrella: lei and name. Null otherwise.
successorEntity	object	The entity that took over after a merger: lei and name. Null otherwise.
registration	object	The LEI itself: initialRegistrationDate, lastUpdateDate, status, nextRenewalDate, managingLou (issuer LEI), corroborationLevel.
bic	array	BIC (SWIFT) codes mapped to the entity.
mic	array	Market Identifier Codes mapped to the entity.
ocid	string	OpenCorporates ID, when mapped.
qcc	string	QCC code, when mapped.
spglobal	array	S&P Global company IDs, when mapped.
conformityFlag	string	Whether the record conforms to GLEIF's data-quality rules.
directParent	object	lei and legalName of the direct accounting parent, or reportingException with the reason none is reported. Null when relationships are off.
ultimateParent	object	The same for the ultimate parent.
directChildrenCount	number	How many direct subsidiaries hold an LEI. Null when relationships are off.
ultimateChildrenCount	number	How many subsidiaries, at any depth, have this entity as ultimate parent.
searchTerm	string	The company name that found the entity; null for LEI lookups.
dataAsOf	string	Publication date of the GLEIF data set the record was read from.
url	string	The entity's page on search.gleif.org.

💡 Use cases

• KYC and onboarding. Verify a counterparty's legal name, registered address, register number and LEI status before you open an account or sign a contract.
• Lead generation. List every active company of a given legal form in a country, with addresses and register numbers, as a clean prospect base.
• Corporate structure. Find who owns a subsidiary, and how many subsidiaries a group has, from the parent data companies report themselves.
• Data enrichment. Add LEIs, BIC codes and register numbers to a CRM or supplier master, or check LEIs that are due for renewal or have lapsed.

❓ FAQ

• Where does the data come from? From GLEIF, the Global Legal Entity Identifier Foundation, which publishes the Global LEI Index as open data under the CC0 licence. It is updated daily; dataAsOf gives the publication date.
• Do I need an API key, a GLEIF account or a proxy? No.
• How fast is it? GLEIF allows about 60 requests a minute, and the Actor keeps under that limit. A request fetches up to 200 entities, so plain searches are fast. With parents and subsidiaries on, each group parent costs two extra requests; turn includeRelationships off for very large listings.
• Why is a parent missing? Companies report their parents to GLEIF themselves. When they don't, reportingException gives the reason, for example NATURAL_PERSONS (owned by people), NON_CONSOLIDATING or NO_KNOWN_PERSON.
• Can I get more than 10,000 results for one name? GLEIF returns at most 10,000 matches per name search. Narrow it with filters, or leave the name empty and list by filters only, which has no limit.
• What is an ELF code? The ISO 20275 code for a legal form, such as 6QQB for a German Aktiengesellschaft. GLEIF publishes the full ELF code list on its website.

🔗 More scrapers by Anyx

• Google Maps Email Extractor
• Yellow Pages Scraper
• Trustpilot Scraper
• Glassdoor Scraper

🤝 Anyx Solutions

We build custom scrapers and data-extraction pipelines.

• Email: tantosthor@gmail.com

🖼 Image credit

Image credit: search.gleif.org