Opbouw, controlecijfer, geaccepteerde en geweigerde voorbeelden en de API-aanroep voor KVK-nummer (Nederland). Elk voorbeeld op deze pagina gaat door dezelfde validators als de gratis identificatievalidator, dus een waarde die hier als geaccepteerd staat, accepteert de validator ook.
| Veld | Waarde |
|---|---|
| Register | GLEIF (bij een LEI geregistreerde entiteiten); het KVK-nummer van de Kamer van Koophandel |
| Opbouw | N{8} |
| Controlecijfer | Geen: alleen de opbouw wordt getoetst. Er wordt geen controlecijfer gepubliceerd: precies 8 cijfers, een voorloopnul hoort bij het nummer (04040577) en 00000000 is geen nummer. De opbouw is de enige toets. |
| Uitgewerkt voorbeeld (geaccepteerd) | 17085815 |
| Genormaliseerde vorm | 17085815 |
| Ook geaccepteerd als invoer | 04040577 |
| Regex (genormaliseerde vorm) | ^[0-9]{8}$ |
| API-aanroep | GET /companies/search?country=NL&company_number=17085815 |
| Btw-nummer | De registergegevens bevatten voor deze identificator geen btw-nummer. |
Het KVK-nummer is het nummer van de Nederlandse Kamer van Koophandel. Prometiam levert alleen Nederlandse rechtspersonen die een LEI hebben en waarvan GLEIF het KVK-nummer vastlegt (BV, NV, SE, coöperaties, OWM, CV en VOF), niet alle Nederlandse bedrijven en geen uittreksel uit het Nederlandse handelsregister: een goed opgebouwd KVK-nummer van een eenmanszaak, een stichting of een vereniging levert niets op. Een nummer van 9 cijfers is een RSIN en wordt geweigerd. Het Nederlandse btw-nummer is een ander nummer en laat zich niet uit het KVK-nummer afleiden.
curl "https://api.prometiam.com/functions/v1/risk-api/companies/search?country=NL&company_number=17085815" \ -H "Authorization: Bearer YOUR_API_KEY"
Notatie van de opbouw: N cijfer · L letter · X cijfer of letter · C controlecijfer of controleteken · {n} n keer herhaald.
Een geldige opbouw en een geldig controlecijfer bewijzen dat een nummer correct is opgebouwd, niet dat een bedrijf het voert. Alleen een opzoeking in het register geeft daar antwoord op.
Registergegevens die de API voor Nederland levert, dragen deze bronvermelding (in de oorspronkelijke bewoording):
Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0. LEI-registered entities only; not an extract of the Dutch commercial register (Handelsregister, KVK).
Start uw gratis proefperiode van 14 dagen · API-documentatie
De proefperiode duurt 14 dagen en omvat 500 credits. Een betaalkaart is vereist, tijdens de proefperiode wordt niets aangerekend; daarna loopt het Starter-plan (9,99 € per maand) tenzij u opzegt.