# NL Bedrijven Compliance Dossier — GLEIF & KvK (`codeclouds/nl-bedrijven-compliance-dossier`) Actor Look up a company by name or LEI code and get its LEI/GLEIF record, resolved Dutch KvK number, legal form and a live KVK insolvency signal in one call — built for KYB/compliance screening. - **URL**: https://apify.com/codeclouds/nl-bedrijven-compliance-dossier.md - **Developed by:** [Dennis](https://apify.com/codeclouds) (community) - **Categories:** Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $10.00 / 1,000 dossier-resultaats This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 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: ```json { "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:** ```json { "bedrijven": ["Heineken N.V."] } ``` **Exact lookup by LEI code (skips name search entirely):** ```json { "bedrijven": ["724500K5PTPSST86UQ23"] } ``` **Batch-screen a supplier list:** ```json { "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. # Actor input Schema ## `bedrijven` (type: `array`): 1-500 bedrijfsnamen (bv. "Heineken N.V.") of exacte 20-karakter LEI-codes om op te zoeken. Elk item levert 1 of meer dossier-records op (meerdere kandidaten bij een naam-zoekopdracht). ## `maxKandidatenPerNaam` (type: `integer`): Hoeveel GLEIF-kandidaten (rechtsvormvarianten, internationale vestigingen) er per opgegeven naam als los dossier-record uitgevoerd worden. Alleen relevant bij naam-zoekopdrachten, niet bij directe LEI-codes. ## `kvkVertragingMs` (type: `integer`): Wachttijd tussen opeenvolgende KVK Open Dataset-verzoeken. De bron heeft een agressieve, ongedocumenteerde rate limit — verhoog dit bij veel NL-bedrijven in 1 run als je 429-fouten in de log ziet. ## Actor input object example ```json { "bedrijven": [ "Heineken N.V." ], "maxKandidatenPerNaam": 3, "kvkVertragingMs": 1100 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "bedrijven": [ "Heineken N.V." ] }; // Run the Actor and wait for it to finish const run = await client.actor("codeclouds/nl-bedrijven-compliance-dossier").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "bedrijven": ["Heineken N.V."] } # Run the Actor and wait for it to finish run = client.actor("codeclouds/nl-bedrijven-compliance-dossier").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "bedrijven": [ "Heineken N.V." ] }' | apify call codeclouds/nl-bedrijven-compliance-dossier --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=codeclouds/nl-bedrijven-compliance-dossier", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "NL Bedrijven Compliance Dossier — GLEIF & KvK", "description": "Look up a company by name or LEI code and get its LEI/GLEIF record, resolved Dutch KvK number, legal form and a live KVK insolvency signal in one call — built for KYB/compliance screening.", "version": "0.1", "x-build-id": "9xL5aQMwSL9OqVQCS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/codeclouds~nl-bedrijven-compliance-dossier/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-codeclouds-nl-bedrijven-compliance-dossier", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/codeclouds~nl-bedrijven-compliance-dossier/runs": { "post": { "operationId": "runs-sync-codeclouds-nl-bedrijven-compliance-dossier", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/codeclouds~nl-bedrijven-compliance-dossier/run-sync": { "post": { "operationId": "run-sync-codeclouds-nl-bedrijven-compliance-dossier", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "bedrijven" ], "properties": { "bedrijven": { "title": "Bedrijfsnamen of LEI-codes", "type": "array", "description": "1-500 bedrijfsnamen (bv. \"Heineken N.V.\") of exacte 20-karakter LEI-codes om op te zoeken. Elk item levert 1 of meer dossier-records op (meerdere kandidaten bij een naam-zoekopdracht).", "default": [ "Heineken N.V." ], "items": { "type": "string" } }, "maxKandidatenPerNaam": { "title": "Max. kandidaten per bedrijfsnaam", "minimum": 1, "maximum": 10, "type": "integer", "description": "Hoeveel GLEIF-kandidaten (rechtsvormvarianten, internationale vestigingen) er per opgegeven naam als los dossier-record uitgevoerd worden. Alleen relevant bij naam-zoekopdrachten, niet bij directe LEI-codes.", "default": 3 }, "kvkVertragingMs": { "title": "Vertraging tussen KVK-verzoeken (ms)", "minimum": 250, "maximum": 10000, "type": "integer", "description": "Wachttijd tussen opeenvolgende KVK Open Dataset-verzoeken. De bron heeft een agressieve, ongedocumenteerde rate limit — verhoog dit bij veel NL-bedrijven in 1 run als je 429-fouten in de log ziet.", "default": 1100 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```