Connect
Op deze pagina leggen we per systeem (software die op de eilanden vaak wordt gebruikt als single source of truth), per eiland en onze API uit hoe alles kan worden geïntegreerd: of wij data ontvangen van uw systeem of dat wij data naar u kunnen zenden.
Onze API: ontvangen en zenden
CVR fungeert als centraal register. Integratie verloopt via de REST API v1. Afhankelijk van uw rol kunt u data naar ons sturen (wij ontvangen) of data bij ons opvragen (wij zenden).
Wat wij ontvangen
Partners sturen ons o.a.: verzekeringsstatus (insurance/status), keuringsresultaten (inspection/status), bewijsstukken (upload), betalingsbevestigingen, mutaties (registratie, eigendom, kenteken). Authenticatie via Bearer token; aanbevolen: Idempotency-Key bij mutaties.
Wat wij zenden
Partners kunnen bij ons o.a. opvragen: kentekenlookup, voertuig- en registratiestatus, verzekering, voertuigkeuring (APK), belastingstatus, enforcement-informatie. Voor enforcement en gemeente is een purposeCode verplicht; voor politie ook caseRef.
Per type systeem: ontvangen of zenden
Hieronder per type software/actor of CVR data ontvangt van dat systeem of data naar dat systeem zendt (of beide).
Verzekeraar
Verzekeringsstatus, polisgegevens, bewijsstukken.
Ontvangen: Wij ontvangen: statusmeldingen (active/inactive/pending), policy + VIN, uploads van bewijsstukken, goed-/afkeuringen.
Zenden: Wij zenden: (optioneel) bevestiging en status na verwerking. Lookup op kenteken kan via enforcement/gemeente-API indien bevoegd.
Belastingdienst
MRB, aanslagen, betalingen.
Ontvangen: Wij ontvangen: (indien gekoppeld) bevestiging van betaling of kwijtschelding.
Zenden: Wij zenden: aanslagen per persoon/jaar, betalingsstatus; events bij start/einde belastingplicht (bij registratie/overschrijving).
Gemeente / Registratie
Kenteken, voertuig, eigenaar, activatie.
Ontvangen: Wij ontvangen: aanmaak voertuig, eigendom/houder, activatie/schorsing, kentekenuitgifte, overschrijvingen.
Zenden: Wij zenden: lookup op kenteken (met purposeCode), voertuig- en registratiestatus, verzekering, keuring (APK) en belasting voor besluitvorming.
Politie / Handhaving
Lookup, blokkades, acties.
Ontvangen: Wij ontvangen: enforcement-acties (block/impound) en caseRef voor audit.
Zenden: Wij zenden: volledige lookup op kenteken (registratie, verzekering, keuring/APK, belasting, blokkades) via POST /enforcement/check; status en acties per kenteken.
Keuringsstation
Voertuigkeuring (APK); keuringsresultaten per registratie.
Ontvangen: Wij ontvangen: keuringsresultaat via POST /inspection/status (registration_id, inspected_at, valid_until, optioneel source).
Zenden: Wij zenden: lookup op kenteken bevat keuringsstatus (is_valid, valid_until); partners met enforcement-rechten kunnen dit opvragen.
Per eiland: systemen en integratie
Op elk eiland kunnen andere pakketten of lokale systemen als single source of truth worden gebruikt. Hieronder een overzicht per eiland en hoe integratie met CVR verloopt.
Bonaire
Vaak: lokale administratie (Excel, documenten), Belastingdienst CN (MRB), verzekeraars (polis).
CVR ontvangt van: gemeente/registratie (voertuig, kenteken, activatie), verzekeraars (status), eventueel belasting (betaling). CVR zendt naar: politie (lookup), gemeente (status voor besluit), belasting (events). Eén digitaal register als bron voor alle partijen.
Curaçao
Vaak: landsverordeningen, eigen registratie, Landsontvanger (belasting), verzekeraars.
CVR ontvangt: registratiebesluiten, eigendom, verzekeringsstatus. CVR zendt: lookup voor politie en gemeente, belasting-events naar Landsontvanger, status voor overschrijving en handhaving.
Sint Maarten
Vaak: lokale overheidsadministratie, verzekeraars, handhaving.
CVR ontvangt: voertuig- en verzekeringsgegevens (o.a. via cc-mail of API). CVR zendt: realtime status voor handhaving en gemeente; verzekeraars hoeven geen aparte koppeling te bouwen als ze via ons platform melden.
Saba
Kleine schaal: beperkte lokale systemen, centrale workflows gewenst.
CVR ontvangt: registratie en verzekeringsstatus (weinig lokale handelingen). CVR zendt: dashboard en status voor eilandadministratie; minder eigen IT nodig.
Sint Eustatius
BES-context: eenvoud en transparantie, uniforme regels.
CVR ontvangt: mutaties zoals op andere BES-eilanden. CVR zendt: beleidsinformatie en status voor bestuur en toezicht.
Hoe aansluiten
Sluit uw systeem aan via de REST API v1. Bekijk de API-documentatie en de Partner Integration Guide voor endpoints, authenticatie en governance.
- API-documentatie — OpenAPI/Swagger en endpoints
docs/PARTNER_INTEGRATION_GUIDE.md— Partner Integration Guide (authenticatie, headers, governance)