NL Bedrijven Compliance Dossier — GLEIF & KvK 🇳🇱🔍

Look up a company by name or LEI code and get its GLEIF/LEI entity record, its resolved Dutch KvK (Chamber of Commerce) number, and a live KVK insolvency signal — all in one call, without needing a KVK API account (which KVK itself restricts to registered businesses). Built as a lightweight KYB/ compliance-screening building block, not a full KYC report.

When should an AI agent use this?

• "Is this counterparty an active, non-insolvent legal entity in the Netherlands?"
• "Resolve the KvK number for this company name so I can look up its filings elsewhere."
• "Screen this list of 20 supplier names for entity status before onboarding."
• "Get the LEI, legal form and registered address for this company."
• "Check whether this Dutch company currently has an active insolvency code."

What this Actor does

• Looks up each input (company name or 20-character LEI code) against GLEIF's global Legal Entity Identifier database — legal name, jurisdiction, LEI status (active/inactive), legal form, registered address
• For Dutch entities, resolves the KvK number directly from the LEI record (GLEIF stores it in registeredAs whenever the entity is registered with KVK, Registration Authority RA000463) — no KVK API account needed
• Enriches resolved KvK numbers with the KVK Open Dataset Basis Bedrijfsgegevens (free, no key): active status, legal form, registration date, and — the key compliance signal — an insolvency code
• Re-ranks GLEIF's own search results by name similarity before returning them: GLEIF's relevance scoring does not always put an exact name match first (see FAQ) — this actor corrects for that instead of passing the raw ranking through
• Supports both fuzzy name search (returns up to N candidates per name) and exact LEI-code lookup
• Fails gracefully per company: a failed KVK lookup (rate limit or temporary unavailability, both observed live from this data source) never crashes the run or fakes a result — it's reported as opgehaald: false with the actual error, and never charged

Input

Field	Type	Description
bedrijven	array of strings	1-500 company names or 20-character LEI codes to look up
maxKandidatenPerNaam	integer	Max GLEIF candidates returned per name search (1-10, default 3)
kvkVertragingMs	integer	Delay between KVK Open Dataset requests in ms (250-10000, default 1100) — increase if you see 429 warnings in the log with many Dutch companies in one run

Output

One record per matched candidate:

{
  "zoekterm": "Heineken N.V.",
  "zoekType": "naam",
  "isNederlandseEntiteit": true,
  "lei": "724500K5PTPSST86UQ23",
  "naamGLEIF": "Heineken N.V.",
  "land": "NL",
  "status": "ACTIVE",
  "rechtsvormCodeGLEIF": "B5PM",
  "kvkNummer": "33011433",
  "kvkBasisgegevens": {
    "kvkNummer": "33011433",
    "actief": true,
    "insolventieCode": null,
    "rechtsvormCode": "BV",
    "datumAanvang": "19730126",
    "postcodeRegio": 10,
    "opgehaald": true,
    "foutmelding": null
  },
  "insolvent": false,
  "adres": {
    "straat": "Tweede Weteringplantsoen 21",
    "stad": "Amsterdam",
    "postcode": "1017ZD",
    "land": "NL"
  },
  "aantalKandidaten": 1,
  "kandidaatVolgnummer": 1,
  "matchZekerheid": "exact",
  "disclaimer": "Indicatief compliance-signaal, geen officieel KYC/KYB-advies of due-diligence-rapport. ..."
}

• insolvent is true/false only when kvkBasisgegevens.opgehaald is true — if the KVK lookup itself failed, insolvent is null, never a silent false. Always check kvkBasisgegevens.opgehaald/ foutmelding before treating a null/false insolvency status as confirmed.
• kvkNummer/kvkBasisgegevens are null for non-Dutch entities (no KVK registration to resolve) or when GLEIF has no registeredAs value on file for a Dutch entity.
• matchZekerheid: "exact" when the returned entity's legal name actually matches the search term (ignoring case/punctuation, so "Heineken NV" matches "Heineken N.V.") or when the search was a direct LEI code lookup (always unambiguous); "kandidaat" when it's merely the best available candidate without a real name match (e.g. GLEIF's own pool ran dry); "geen_match" when GLEIF has no LEI record for the search term at all (most SMEs and sole proprietorships don't have an LEI — this is expected, not an error). This is based on actual name similarity, not on list position — the top-ranked candidate for a poorly-matching search is still "kandidaat", never a false "exact".
• aantalKandidaten/kandidaatVolgnummer tell you how many candidates a name search returned and which position this record is — useful when a name matches multiple legal-form variants of the same group (e.g. a holding and its operating company).

Use cases

Single company check:

{ "bedrijven": ["Heineken N.V."] }

Exact lookup by LEI code (skips name search entirely):

{ "bedrijven": ["724500K5PTPSST86UQ23"] }

Batch-screen a supplier list:

{ "bedrijven": ["ASML Holding", "Heineken N.V.", "Philips"], "maxKandidatenPerNaam": 2 }

Pricing

This Actor uses Apify's Pay-Per-Event (PPE) pricing model.

• Actor Start: $0.00005 (Apify default)
• dossier-resultaat: $0.01 per company candidate returned with its GLEIF/LEI entity data
• kvk-verrijking: $0.02 extra, only when the matched entity is Dutch and its KvK number was successfully enriched with KVK Open Dataset data
• insolventie-signaal: $0.08 extra, only when the KVK Open Dataset reports an active insolvency code for the matched company — the highest-value alert this actor can deliver

Legal

• Data sources: GLEIF (Global Legal Entity Identifier Foundation, api.gleif.org, fully open, no key) and KVK Open Dataset Basis Bedrijfsgegevens (opendata.kvk.nl, CC BY 4.0, no key). Both are entity-level data with no natural-person information involved.
• This actor does not use KVK's official Zoeken/Basisprofiel API — KVK's own developer terms exclude private individuals from obtaining an API key for those products. It also does not use any paid third-party KvK reseller. Everything here runs on the two free, key-less sources above.
• This is not a KYC/KYB verdict, credit report, or due-diligence report. It is an indicative compliance signal, explicitly disclaimed as such on every result (disclaimer field). Coverage is limited to entities that have an LEI — most SMEs and sole proprietorships do not, and will return no match. Always verify via the official KVK Handelsregister before relying on this for an actual onboarding/compliance decision.
• The insolvency signal is a snapshot from a data source with confirmed reliability limitations (an aggressive, undocumented rate limit, and occasional "temporarily unavailable" responses observed live) — a null/missing signal means "could not check right now", not "confirmed not insolvent".

FAQ

Q: Why does a name search sometimes return a different company than I expected? A: GLEIF's own search relevance scoring does not always rank an exact legal-name match first — for example, searching "Heineken N.V." literally returns "Heineken Finance NV" and "Heineken Holding N.V." ahead of "Heineken N.V." itself in GLEIF's raw response. This actor re-ranks the candidate pool by name similarity before returning results, but if you need a guaranteed single entity, use its LEI code directly instead of a name search.

Q: My company search returned zero results — is something broken? A: Most likely not. Coverage is limited to entities registered with GLEIF (an LEI is required mainly for listed companies, bond issuers, and regulated financial-market participants) — most SMEs and sole proprietorships never register for an LEI and will legitimately return no match.

Q: Why is there no KvK number or insolvency data for a company I know is Dutch? A: Either the GLEIF record has no registeredAs value for this entity (not every LEI record has this field populated), or the KVK Open Dataset lookup failed for this specific KvK number at the time of the run (check kvkBasisgegevens.foutmelding — this source is confirmed to have an aggressive rate limit and occasional temporary-unavailable responses).

---

Zoekwoorden: KvK-nummer opzoeken, bedrijf compliance check, tegenpartij screening, faillissement check bedrijf, KYB Nederland, due diligence bedrijf, insolventie check KvK, GLEIF LEI opzoeken.

Keywords

kyb, kyc, compliance, due diligence, gleif, lei lookup, kvk number, kvk check, insolvency, bankruptcy check, counterparty screening, netherlands company data

Changelog

0.1.0

• Initial release: GLEIF name/LEI lookup, name-similarity re-ranking of GLEIF's raw search results, Dutch KvK number resolution via GLEIF's registeredAs field, and KVK Open Dataset insolvency enrichment.