Company Ownership Scraper — LEI Parents & Subsidiaries

Scrape official legal entity data from GLEIF: 2.5M+ companies across 100+ jurisdictions, with legal names, registered addresses, company numbers — and the two fields a KYC or supplier-risk team cannot get free anywhere else.

1. Who owns whom

GLEIF is the only free, global, official source that publishes direct and ultimate parent relationships between legal entities, with the accounting periods they were reported for.

Deutsche Bank AG alone has 330 direct subsidiaries on file (measured 2026-08-14). A live run against the first five returned entities in Spain, Hong Kong, Mauritius and the United States — a group footprint you would otherwise assemble by hand from five national registries.

You can also work top-down: pass a parent LEI to ownedBy and get its subsidiaries directly.

2. Whether the entity still maintains its identity

An LEI must be renewed annually against an authoritative source. 1,190,660 records currently sit at registration status LAPSED (measured 2026-08-14) — meaning the entity stopped revalidating.

This is not the same question as whether the company is active, and the two frequently disagree. A live search for Deutsche Bank returned, in the first 20 records, a Swiss pension foundation that is entityStatus: ACTIVE but registrationStatus: LAPSED, plus 6 entities with an overdue renewal date. Read only entity.status and every one of those looks clean.

Both fields are returned, plus isLapsed, isRenewalOverdue, daysUntilRenewal and isActive (the only combination that means fully current: entity ACTIVE and registration ISSUED).

What else you get

• corroborationLevel — how well evidenced the record is. FULLY_CORROBORATED means validated against a public registry; ENTITY_SUPPLIED_ONLY means the company simply said so. Materially different levels of trust, and it is right there in the data.
• registeredAs + registrationAuthority — the company number in its home registry and which registry that is. This is the join key from GLEIF to national company data.
• isCrossBorderHq — the headquarters sits in a different country to the registered address. Not wrongdoing, but exactly what a jurisdiction-risk check looks for.
• Group summaries — parent chain, subsidiary count, jurisdictions spanned, and how many group members have a lapsed LEI.
• LEI is a stable key. It survives name changes, which is why matching on it beats matching on a company name.

Who uses this

• KYC, AML and onboarding — resolving a counterparty to an official identifier and checking whether it still maintains it.
• Supplier and third-party risk — mapping a supplier's ownership before signing, and spotting groups spanning unexpected jurisdictions.
• B2B data enrichment — attaching a global, stable identifier and a home registry number to a CRM record.
• Financial research — mapping fund and subsidiary structures.

Input

Give at least one of searchTerm, leis, country or ownedBy. An unfiltered walk across 2.5 million records is refused rather than started.

Field	Type	Default	Notes
searchTerm	string	Deutsche Bank	Full-text across legal and other names
leis	array	[]	Exact 20-character LEIs, looked up directly
country	string	""	Two-letter country of the registered address
ownedBy	string	""	Parent LEI — map a group from the top down
entityStatus	string	""	Is the company active
registrationStatus	string	""	Is the LEI maintained — a different question
lapsedOnly	boolean	false	Keep only lapsed registrations
includeRelationships	boolean	true	Direct and ultimate parents
includeChildren	boolean	false	Off by default — large groups have hundreds
maxChildrenPerEntity	integer	50
maxEntities	integer	100	200 per page

lapsedOnly narrows the entity rows only. Group summaries are built from everything, or a group would look entirely lapsed by construction.

Output

entity — lei, legalName, otherNames, entityStatus, registrationStatus, isLapsed, isRenewalOverdue, daysUntilRenewal, corroborationLevel, jurisdiction, legalAddress, headquartersAddress, isCrossBorderHq, registeredAs, registrationAuthority, bic, gleifUrl.

relationship — relationship (direct_parent, ultimate_parent, direct_child), relatedLei, relatedLegalName, relatedCountry, relatedEntityStatus, relatedIsLapsed.

group_summary — directParentName, ultimateParentName, hasReportedParent, isUltimateParentItself, directChildren, childCountries, jurisdictionsInGroup, lapsedRelatedEntities, lapsedSharePercent.

Limits

• Most entities report no parent, and that is normal. GLEIF answers those with a 404, which this actor records as hasReportedParent: false rather than treating as an error. Absence of a parent is not evidence of independence — it means none was reported.
• Coverage is strong for financial institutions and regulated entities, thinner for small private companies that have never needed an LEI.
• Ownership is legal consolidation, not beneficial ownership. It answers who consolidates the accounts, not who ultimately benefits.

Pricing

Pay per event. $0.001 per entity, $0.002 per ownership relationship, $0.05 per group summary.