Developer docs

API Documentatie v1.0

Integreer actuele Nederlandse bedrijfsdata direct in jouw CRM of applicatie. Alle endpoints, velden en referentielijsten op één plek.

Op zoek naar de CRM- of Query-API, of naar de velden van Register-data? Bekijk de volledige technische documentatie per product.

De Ad Hoc Data API is een RESTful interface voor real-time toegang tot 3,8 miljoen Nederlandse bedrijfsregistraties uit de Register-data. Ontwikkelaars integreren bedrijfsdata in CRM-systemen, lead-scoring tools en marketing automation platforms via JSON-responses met ApiKey-header authenticatie. Online-data is op dit moment alleen via export (Excel of CSV) beschikbaar.

Authenticatie van deze API gaat middels een ApiKey header. Deze key is in de portal van Ad Hoc Data aan te maken. Mocht je deze key nog niet hebben, vraag deze dan op bij de opdrachtgever. Daarnaast moet bij een POST call de Content-Type header gevuld worden.

Verplichte headers
  • ApiKey: {key}
  • Content-Type: application/json
  • Deze API verwacht en levert data uit in JSON formaat. Bij een 415, Unsupported Media Type status, check de Content-Type header. Meer informatie over RESTful API services.
  • JSON properties hieronder beschreven zijn case sensitive. Bij afwijken in casing kan het zijn dat de waarde niet wordt verwerkt.
  • Er geldt een limiet van 2 calls per seconde. Bij overschrijden van dit limit zal een 429, Too Many Requests geretourneerd worden.

URL parameters

  • preview = true / false, default: true
  • take = integer, default: 1
  • skip = integer, default: 0
  • fields = komma-gescheiden output velden, default: zie output

Voorbeeld output

Voor de exacte output data, zie output.

{
  "take": 1,
  "skip": 3,
  "preview": false,
  "fields": "AHDNR, KVKNR, KVKSUB, VESTNR, BedrijfsnaamKort, STRAAT, HUISNR, HUISNRAANV, PCSTRAAT, WPLSTRAAT, TELEFOON_NETNR, TELEFOON_ABONNEENR, MOBIEL_NUMMER, EMAIL, WWW, SBI1, SBI2, SBI3, OPRICHTINGSDATUM, MUTATIEDATUM",
  "data": [
    {
      "AHDNR": "ADH00000ADAZEFF",
      "DOSSIERNR": "28077834",
      "SUBDOSSIERNR": "0000",
      "VESTIGINGSNR": "000017817110",
      "FANAAM": "Ad Hoc Data B.V.",
      "STRAAT": "Koninginnegracht",
      "HUISNR": "46",
      "HUISNRTOEV": "1",
      "POSTCODE": "2514AD",
      "WOONPLAATS": "'s-Gravenhage",
      "TELNET": "070",
      "TELABO": "2400862",
      "EMAIL": "[email protected]",
      "URL": "www.adhocdata.nl",
      "SBIHOOFDACT": "7312",
      "OMSHOOFDACT": "7312",
      "OPRICHTINGSDATUM": 19980629,
      "MUTATIEDATUM": 20200813
    }
  ],
  "receipt": {
    "DataTransactionId": "c66a3020-3c05-4d92-81c1-b6c28391f18d",
    "Records": 1
  }
}
FieldData typeData lengthOmschrijving
AHDNR string 255
DOSSIERNR string 8
SUBDOSSIERNR string 4
VESTIGINGSNR string 12
HOOFDFIL string *1
FANAAM string 255
VENNAAM string 255
STRAAT string 255
HUISNR integer
HUISNRTOEV string 255
POSTCODE string 255
WOONPLAATS string *255
GEMEENTECODE integer *
PROVINCIECODE string *2
POSTBUSNR string 10
POSTBUSPC string 7
POSTBUSWPL string *255
TELNET string 5
TELABO string 8
MOBIEL string 11
EMAIL string 255
URL string 255
Rechtsvorm string *2
SBI1 string *255
SBI2 string *255
SBI3 string *255
SBI1_2025 string *6
SBI2_2025 string *6
SBI3_2025 string *6
OPRICHTINGSDATUM integer
OMZETKLASSE string *2
FILIALEN integer
VSI string *1
DOCHTERBEDRIJF boolean
MOEDERBEDRIJF boolean
FRANCHISEGEVER boolean
FRANCHISENEMER boolean
TWITTER boolean
FACEBOOK boolean
LINKEDIN boolean
ANALYTICS boolean
WEBSHOP boolean
FAMILIEBEDRIJF boolean
GROEIEND boolean
STABIEL boolean
MVO boolean
CEBUCOCODE string *4
COROPCODE string *2
EGGCODE integer *
NIELSENCODE integer *
WATERSCHAP string *255
ACN_X integer
ACN_Y integer
INDVERHUIS boolean
INDBVG boolean
ECONACTIEF boolean
SURSUIT integer
SURSIN integer
FAILUIT integer
INDUIT boolean
FAILVERN integer
* = Zie de Referentielijsten sectie hieronder voor de toegestane waarden voor dit veld.
Input veld(en)Endpoint URL
SBI1_2025, SBI2_2025, SBI3_2025GEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2025_sbi
OMZETKLASSEGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2018_omzetklassen
RechtsvormGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2018_rechtsvormen
PROVINCIECODEGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2018_provincies
GEMEENTECODEGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2018_gemeenten
CEBUCOCODEGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2018_cebuco
COROPCODEGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2018_corop
EGGCODEGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2018_egg
NIELSENCODEGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2018_nielsen
HOOFDFILGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2018_vestigingstypes
WOONPLAATS, POSTBUSWPLGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2018_plaatsnamen
VSIGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/VSI
PAND_STATUSGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2020_pandstatus
VERBLIJFSOBJECT_STATUSGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2020_verblijfsobject_status
TYPE_ADRESSEERBAAR_OBJECTGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2020_adresseerbaar_object_types
VERBLIJFSOBJECT_WONINGTYPEGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2020_verblijfsobject_woningtypes
KOOPHUURGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2020_koophuur
ENERGIE_LABELGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2020_Energie_Labels
ENERGIE_WONINGTYPEGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2020_Energie_Woningtypes
NETBEHEERDER_WARMTEGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2020_Netbeheerders_Warmte
NETBEHEERDER_ELEKTRAGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2020_Netbeheerders_Elektra
NETBEHEERDER_GASGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2020_Netbeheerders_Gas
NETBEHEERDER_WATERGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2020_Netbeheerders_Water
WATERSCHAPGEThttps://api.adhocdata.nl/references/nl-basis/1.0/lists/2020_Waterschapen
Overig
FieldPreviewStandaard uitvoerData typeData lengthOmschrijving
AHDNRstring255
DOSSIERNRstring8
SUBDOSSIERNRstring4
VESTIGINGSNRstring12
HOOFDFILstring
FANAAMstring255
VENNAAMstring255
STRAATstring255
HUISNRinteger
HUISNRTOEVstring255
POSTCODEstring255
WOONPLAATSstring255
GEMEENTEstring
PROVNAAMstring
POSTBUSNRstring10
POSTBUSPCstring7
POSTBUSWPLstring255
TELNETstring5
TELABOstring8
TELNRstring
MOBIELstring11
EMAILstring255
URLstring255
RECHTSVORMstring
SBIHOOFDACTstring6
OMSHOOFDACTstring
SBINEVENACT1string6
OMSNEVENACT1string
SBINEVENACT2string6
OMSNEVENACT2string
OPRICHTINGSDATUMinteger
KLASSEWPstring
AANTALWPinteger
CPFUNCTIEstring
CPSEXEstring1
CPTITELstring255
CPVOORLstring255
CPTUSSENVstring255
CPACHTERstring255
KLASSEOMZOMSstring
FILIALENinteger
VSIstring
MUTATIEDATUMinteger
IMPORTERENDboolean
EXPORTERENDboolean
DOCHTERBEDRIJFboolean
MOEDERBEDRIJFboolean
FRANCHISEGEVERboolean
FRANCHISENEMERboolean
TWITTERboolean
FACEBOOKboolean
LINKEDINboolean
WEBSHOPboolean
THUISWINKELWBboolean
ANALYTICSboolean
FAMILIEBEDRIJFboolean
GROEIENDboolean
STABIELboolean
MVOboolean
CEBUCONAAMstring
COROPNAAMstring
EGGNAAMstring
NIELSENOMSstring
WATERSCHAPstring255
ACN_Xinteger
ACN_Yinteger
ETRS89_Xdecimal
ETRS89_Ydecimal
INDVERHUISboolean
INDBVGboolean
ECONACTIEFboolean
NONMAILboolean
SURSUITinteger
SURSINinteger
FAILUITinteger
INDUITboolean
FAILVERNinteger

Klaar om te integreren?

Vraag een API-sleutel aan of neem contact op voor vragen over een CRM-koppeling.