GLEIF LEI Lookup

🔎 GLEIF LEI lookup for company checks

Compliance, procurement, and data teams can search public GLEIF data by company name, exact LEI code, or country. Each saved row is one accepted legal entity with its official identity, registration, address, ownership, security, and deterministic decision facts. This gives you structured company data for vendor onboarding, counterparty checks, KYB review, and other business workflows.

When the same LEI appears through more than one submitted value, the Actor saves the first accepted match. The matchedInput field shows the first name, LEI code, or country code that found the saved entity.

• Use GLEIF LEI Search to find matching legal entities by company name or country.
• Use LEI Code Lookup to check a known 20-character LEI and its registry facts.
• Use Company LEI Lookup to add legal names, addresses, and status to a company list.
• Use Legal Entity Identifier Lookup to find official identity and registration details.
• Use GLEIF LEI Lookup to review ownership context, securities, and decision fields for matched entities.

📦 Export official GLEIF entity data

What you get

Each dataset row contains one accepted entity. GLEIF may leave fields null or arrays empty when it does not provide the data or when the selected output detail is compact.

Identity and registry facts

Rows include the LEI, the first matching input, an official GLEIF record link, legal and alternate names, entity status, category, jurisdiction, legal form, registration authority, local registration number, BIC codes, registration dates, registration status, and managing LOU.

Use these fields to check whether a known LEI is active, has an issued registration, and is current for renewal when GLEIF provides those facts.

Relationship and security context

When requested and available, rows include legal and headquarters addresses, direct and ultimate parent details, child counts, ownership transparency, relationship edges, reporting exceptions, and ISIN-linked securities.

Decision and monitoring

Decision fields include the selected policy, recommended action, risk score and band, risk factors, review flags, identity confidence and verdict, ownership transparency, onboarding complexity, and renewal state. A named watchlist can add first-seen, unchanged, or changed status with the changed fields.

Batch summary

Batch runs also write a PORTFOLIO_SUMMARY key-value output with totals, status and risk distributions, country exposure, a prioritized review queue, and watchlist change snapshots when a watchlist name is used.

▶️ Run a GLEIF company lookup

Run steps

1. Open the Actor input.
2. Add company names or exact LEI codes in Company names or LEI codes.
3. Optional: add ISO country codes such as US, GB, or DE in Countries.
4. Set Max records to limit the number of accepted entities saved. Leave it empty or set it to 0 to return all available results until the source is exhausted.
5. Choose Entity status, Entity category, Decision policy, and Output detail.
6. Choose relationship, securities, or graph data based on the extra context you need.
7. Optional: add a Watchlist name or Registration number for repeat comparisons.
8. Start the Actor and open the default dataset.

For a smaller wait and payload, choose essential output and leave optional relationship, securities, and graph data off. The structured rows keep source facts together for a CRM, warehouse, spreadsheet, or review queue.

⚙️ Input

Use queries for company names or exact LEI codes. Use countries for country-filtered discovery, or fill both to combine named lookups with a country filter. Blank status and category filters keep all values.

Input fields

Field	Type	What it does
queries	array of strings	Company names or exact 20-character LEI codes to look up.
countries	array of strings	ISO 3166-1 alpha-2 country codes for filtered discovery, such as US or GB.
maxRecords	integer	Maximum accepted LEI entities to save. Leave it empty or set it to 0 to return all available results until the source is exhausted.
entityStatus	string	Keeps entities with the selected GLEIF operating status. Leave blank for all statuses.
entityCategory	string	Keeps entities in the selected broad GLEIF category. Leave blank for all categories.
policyProfile	string	Chooses how status, renewal, identity, and ownership facts affect the deterministic decision.
outputProfile	string	Chooses how much source data and review context to include in each entity.
includeRelationships	boolean	Adds parent, ultimate parent, child-count, and relationship signals when available.
includeSecurities	boolean	Adds ISIN and security links when GLEIF provides them.
includeGraphEdges	boolean	Adds relationship data shaped for graph tools when available.
watchlistName	string	Uses the same name on repeat runs to compare first-seen, unchanged, or changed entities.
registrationNumber	string	Compares a local registration number with the GLEIF registration value.

Default input example

This is the public input from a successful current-beta default run:

{
  "queries": [
    "Apple",
    "HWUPKR0MPOU8FGXBT394"
  ],
  "countries": [
    "US"
  ],
  "maxRecords": 25,
  "entityStatus": "",
  "entityCategory": "",
  "policyProfile": "balanced",
  "outputProfile": "standard",
  "includeRelationships": true,
  "includeSecurities": false,
  "includeGraphEdges": false
}

The form starts with Apple, HWUPKR0MPOU8FGXBT394, US, and 25 as prefilled values.

Decision and output detail

Use policyProfile to choose the posture for deterministic decision fields. Use outputProfile to choose the amount of detail:

• essential: core identity, status, dates, addresses, and compact decision fields.
• decision: decision evidence, registration-number comparison, and watchlist changes.
• standard: alternate names, legal and registration labels, BIC codes, and parent basics.
• full: requested relationship and ISIN/security arrays when available.

Use the relationship, securities, and graph switches only when you need those extra fields. Use the same watchlistName on later runs to compare an entity with its earlier snapshot.

🧾 Output

All four output profiles use the same entity-row shape. Essential and decision profiles may leave optional source fields null or arrays empty. Standard and full profiles keep more available source detail. The table below lists every public dataset field, including nested fields.

Dataset link

The Actor output exposes a results link to successful GLEIF entity rows in the default dataset.

Entity row fields

Field	Type	What it does
lei	string	Official 20-character Legal Entity Identifier from GLEIF.
matchedInput	string	First submitted name, LEI code, or country code that found this entity.
recordUrl	string (URL)	Link to the entity's official GLEIF record.
legalName	string	Official legal entity name from GLEIF.
otherNames	array of strings	Other, former, or transliterated names from GLEIF.
entity	object	Legal entity type and registry facts.
entity.status	string or null	Operating status from GLEIF.
entity.category	string or null	Broad entity category from GLEIF.
entity.subcategory	string or null	Entity subcategory when available.
entity.jurisdiction	string or null	Legal jurisdiction code from GLEIF.
entity.legalForm	object or null	Legal form code and name.
entity.legalForm.code	string or null	Legal form code from GLEIF.
entity.legalForm.name	string or null	Legal form name from GLEIF.
entity.registeredAs	string or null	Local registration number from GLEIF.
entity.registrationAuthority	object or null	Registration authority code and name.
entity.registrationAuthority.id	string or null	Registration authority ID.
entity.registrationAuthority.name	string or null	Registration authority name.
entity.bicCodes	array of strings	BIC or SWIFT codes linked to the entity.
registration	object	LEI registration dates and status.
registration.status	string or null	LEI registration status from GLEIF.
registration.initialRegistrationDate	date or null	Date when GLEIF first registered this LEI.
registration.lastUpdateDate	date or null	Date when GLEIF last updated the LEI record.
registration.nextRenewalDate	date or null	Next LEI renewal date from GLEIF.
registration.managingLou	string or null	Local Operating Unit that manages the LEI record.
registration.registrationNumberMatch	string or null	Whether the supplied local number matched the GLEIF value: matched, different, or not_available.
legalAddress	object or null	Official legal address from GLEIF.
legalAddress.lines	array of strings	Address lines from GLEIF.
legalAddress.city	string or null	City in the legal address.
legalAddress.region	string or null	Region, state, or subdivision in the legal address.
legalAddress.postalCode	string or null	Postal code in the legal address.
legalAddress.country	string or null	ISO country code in the legal address.
headquartersAddress	object or null	Official headquarters address from GLEIF.
headquartersAddress.lines	array of strings	Address lines from GLEIF.
headquartersAddress.city	string or null	City in the headquarters address.
headquartersAddress.region	string or null	Region, state, or subdivision in the headquarters address.
headquartersAddress.postalCode	string or null	Postal code in the headquarters address.
headquartersAddress.country	string or null	ISO country code in the headquarters address.
parents	object	Direct and ultimate parent facts.
parents.direct	object or null	Direct accounting parent when GLEIF reports one.
parents.direct.lei	string or null	LEI of the direct parent when available.
parents.direct.legalName	string or null	Legal name of the direct parent when available.
parents.ultimate	object or null	Ultimate accounting parent when GLEIF reports one.
parents.ultimate.lei	string or null	LEI of the ultimate parent when available.
parents.ultimate.legalName	string or null	Legal name of the ultimate parent when available.
parents.childCount	integer or null	Number of known child entities from GLEIF.
parents.ownershipOpacity	string or null	Ownership transparency signal based on GLEIF relationship data.
relationships	array of objects	GLEIF relationship records for this entity. It is empty when not requested or unavailable.
relationships[].relationshipType	string or null	Relationship type from GLEIF.
relationships[].relatedLei	string or null	LEI of the related entity when available.
relationships[].relatedName	string or null	Legal name of the related entity when available.
relationships[].direction	string	Direction from this entity: parent, child, or other.
relationships[].status	string or null	Relationship status from GLEIF.
relationships[].reportingException	string or null	GLEIF reason given when relationship details are unavailable.
securities	array of objects	ISIN-linked securities from GLEIF. It is empty when not requested or unavailable.
securities[].isin	string	International Securities Identification Number linked to the LEI.
securities[].name	string or null	Security name from GLEIF when available.
decision	object	Deterministic decision signals based on GLEIF facts and the selected policy.
decision.policyProfile	string	Policy used for this entity.
decision.recommendedAction	string	Next action suggested by the selected policy.
decision.riskScore	integer	Risk score from 0 to 100 based on source facts.
decision.riskBand	string	Risk group for sorting and review.
decision.riskFactors	array of strings	Source facts that add to the risk score.
decision.reviewFlags	array of strings	Flags that may need human review.
decision.identityConfidence	integer	Match signal from 0 to 100 for the submitted target.
decision.identityVerdict	string	Readable identity match result.
decision.ownershipTransparency	string	Readable view of ownership data coverage.
decision.onboardingComplexity	string	Suggested onboarding effort for this entity.
decision.renewalState	string	Renewal state based on GLEIF registration dates.
watchlist	object or null	Watchlist comparison when a watchlist name is supplied.
watchlist.name	string	Name used for the watchlist comparison.
watchlist.changeStatus	string	Comparison status: first_seen, unchanged, or changed.
watchlist.changes	array of objects	Source facts that changed since the previous snapshot.
watchlist.changes[].field	string	Name of the changed public field.
watchlist.changes[].previous	string, number, boolean, or null	Earlier value from the watchlist snapshot.
watchlist.changes[].current	string, number, boolean, or null	Current value from this run.

Example entity row

The following shortened row comes from a successful current-beta full run. The real securities array has more entries and is shown as "..." here only to keep the example small; the other shown values are from that row.

{
  "lei": "HWUPKR0MPOU8FGXBT394",
  "matchedInput": "HWUPKR0MPOU8FGXBT394",
  "recordUrl": "https://api.gleif.org/api/v1/lei-records/HWUPKR0MPOU8FGXBT394",
  "legalName": "Apple Inc.",
  "otherNames": [
    "Apple Computer, Inc."
  ],
  "entity": {
    "status": "ACTIVE",
    "category": "GENERAL",
    "subcategory": null,
    "jurisdiction": "US-CA",
    "legalForm": {
      "code": "H1UM",
      "name": "For-Profit Corporation General Stock"
    },
    "registeredAs": "806592",
    "registrationAuthority": {
      "id": "RA000598",
      "name": "Secretary of State - Business Entity Records"
    },
    "bicCodes": [
      "APLEUS66XXX"
    ]
  },
  "registration": {
    "status": "ISSUED",
    "initialRegistrationDate": "2012-06-06",
    "lastUpdateDate": "2026-03-03",
    "nextRenewalDate": "2027-03-08",
    "managingLou": "5493001KJTIIGC8Y1R12",
    "registrationNumberMatch": "different"
  },
  "legalAddress": {
    "lines": [
      "C/O C T Corporation System",
      "330 N. Brand Blvd",
      "Suite 700"
    ],
    "city": "Glendale",
    "region": "US-CA",
    "postalCode": "91203",
    "country": "US"
  },
  "headquartersAddress": {
    "lines": [
      "One Apple Park Way"
    ],
    "city": "Cupertino",
    "region": "US-CA",
    "postalCode": "95014",
    "country": "US"
  },
  "parents": {
    "direct": null,
    "ultimate": null,
    "childCount": 8,
    "ownershipOpacity": "medium"
  },
  "relationships": [
    {
      "relationshipType": "IS_DIRECTLY_CONSOLIDATED_BY",
      "relatedLei": "549300MF6CNUB2URPE58",
      "relatedName": null,
      "direction": "child",
      "status": "ACTIVE",
      "reportingException": null
    },
    {
      "relationshipType": "IS_DIRECTLY_CONSOLIDATED_BY",
      "relatedLei": "549300UJWEUFNYXPJ620",
      "relatedName": null,
      "direction": "child",
      "status": "ACTIVE",
      "reportingException": null
    },
    {
      "relationshipType": "IS_DIRECTLY_CONSOLIDATED_BY",
      "relatedLei": "549300YX4S1LLSMK2627",
      "relatedName": null,
      "direction": "child",
      "status": "ACTIVE",
      "reportingException": null
    },
    {
      "relationshipType": "IS_DIRECTLY_CONSOLIDATED_BY",
      "relatedLei": "5493004SYPRAVRVNK561",
      "relatedName": null,
      "direction": "child",
      "status": "ACTIVE",
      "reportingException": null
    },
    {
      "relationshipType": "IS_DIRECTLY_CONSOLIDATED_BY",
      "relatedLei": "5493006LHHR4CLPX4Q79",
      "relatedName": null,
      "direction": "child",
      "status": "ACTIVE",
      "reportingException": null
    },
    {
      "relationshipType": "IS_DIRECTLY_CONSOLIDATED_BY",
      "relatedLei": "549300G81RQKP7XW2N18",
      "relatedName": null,
      "direction": "child",
      "status": "ACTIVE",
      "reportingException": null
    },
    {
      "relationshipType": "IS_DIRECTLY_CONSOLIDATED_BY",
      "relatedLei": "5493004QI6E3PJNCEB09",
      "relatedName": null,
      "direction": "child",
      "status": "ACTIVE",
      "reportingException": null
    },
    {
      "relationshipType": "IS_DIRECTLY_CONSOLIDATED_BY",
      "relatedLei": "2549008YU9EOMHFUA249",
      "relatedName": null,
      "direction": "child",
      "status": "ACTIVE",
      "reportingException": null
    }
  ],
  "securities": "...",
  "decision": {
    "policyProfile": "investment",
    "recommendedAction": "review_with_checks",
    "riskScore": 43,
    "riskBand": "medium",
    "riskFactors": [
      "active entity",
      "issued LEI registration",
      "current renewal",
      "no parent relationship reported"
    ],
    "reviewFlags": [
      "registration number differs"
    ],
    "identityConfidence": 98,
    "identityVerdict": "strong_match",
    "ownershipTransparency": "limited",
    "onboardingComplexity": "enhanced",
    "renewalState": "current"
  },
  "watchlist": {
    "name": "qa-watchlist",
    "changeStatus": "first_seen",
    "changes": []
  }
}

Batch runs also write the PORTFOLIO_SUMMARY key-value output described above. The default dataset remains the place to read the complete entity rows.

💳 Pricing

This Actor uses pay-per-event pricing. You pay once for each accepted LEI entity saved to the dataset. The current event price is $0.00001 per accepted entity.

What is charged

Optional relationship, security, watchlist, and decision fields are part of the saved entity. They do not create extra charge events. A run that saves no entity creates no LEI entity event.

Limits and scope

Leave Max records empty or set it to 0 to return all available results until the source is exhausted. A positive value caps the accepted entities saved in the run. Relationship and securities enrichment can add wait time on large exports, and GLEIF may not provide every address, parent, relationship, ISIN, BIC, or watchlist value. Decision fields are deterministic indicators from GLEIF facts, not legal, compliance, or financial advice.

This Actor uses public GLEIF data. It does not provide sanctions, PEP, adverse media, OFAC, SEC, OpenCorporates, Companies House, or legal advice.

🔌 Integrations

Use the Apify API to start runs and read the default dataset. Export saved rows as JSON, CSV, Excel, XML, RSS, or HTML. Apify can also schedule repeat runs and send run data to supported webhooks and integrations.

Tutorial

❓ FAQ

What happens when the same entity matches more than one input?

The first accepted match is saved. Later matches for the same LEI are ignored, and matchedInput keeps the first name, LEI code, or country code that found the entity.

Can I look up a known LEI code?

Yes. Add the exact 20-character code to queries. The saved row includes the LEI, legal name, registration facts, addresses, and an official GLEIF record link when the source returns a match.

Can I use the output through the Apify API?

Yes. Start the Actor through the Apify API, then read the default dataset or export its saved rows for your workflow.

What happens when I leave Max records empty?

The Actor returns all available results until the source is exhausted. Setting maxRecords to 0 has the same meaning. A positive value limits the number of accepted entities saved.

Why are some fields null or empty?

GLEIF does not expose every relationship, security, address detail, or code label for every entity. Optional fields can also stay empty when the related input switch is off. The Actor keeps unavailable source data empty instead of inventing values.

Do I need a GLEIF API key?

No. The Actor uses public GLEIF data and does not ask for GLEIF credentials, cookies, or a private source account.

Does this screen sanctions or provide legal advice?

No. It uses GLEIF data only. Use a separate source for sanctions, PEP, adverse media, or other risk lists, and get professional advice for legal or compliance decisions.

📝 Changelog

2.0: Streamlined LEI entity results

• Each saved entity now identifies the input that matched it and includes a direct link to its official GLEIF record.
• Broad searches can return all available matching entities when Max records is left empty or set to 0.

v1.0

• Lowered the price for each accepted LEI entity.
• Added relationship, securities, decision, watchlist, and portfolio-summary data to the public output.

v0.0

• Initial release.

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

🔗 Related Actors

• Pappers Sirene Scraper can search French company registry data with SIREN/SIRET identifiers, addresses, and official status.
• LinkedIn Company Scraper can add public company profile, industry, size, and location data to an entity review.
• Business Address Scraper can check physical addresses shown on a company's public website and retain source evidence.
• GLEIF LEI Lookup - Counterparty Decision Engine focuses on deterministic counterparty onboarding decisions from GLEIF data.
• GLEIF LEI Lookup and Corporate Ownership for AI Agents focuses on parent and child relationship data for GLEIF ownership reviews.

Made with ❤️ by Maxime Dupré