Dezelfde database als het scherm, rechtstreeks in je eigen systeem. Zoeken op alle filters, een bedrijf opvragen op KVK-nummer, en een lijst nummers omzetten naar volledige regels.
Log in op de tool en ga naar Account. Daar maak je een sleutel aan en zie je hem één keer. Wij bewaren hem niet, alleen zijn vingerafdruk en de eerste twaalf tekens, dus schrijf hem meteen op. Kwijt is kwijt: dan trek je hem in en maak je een nieuwe. Je mag er vijf tegelijk open hebben staan.
Elk verzoek heeft de sleutel nodig. Twee vormen, kies er één:
Authorization: Bearer b2b_1234abcd…
x-api-key: b2b_1234abcd…
Zonder sleutel krijg je 401, met een ingetrokken sleutel ook. Het basisadres is
https://mijnb2bdata.nl/v1.
Hoeveel bedrijven voldoen aan een filter. Telt niet mee voor je limiet, dus je mag hier zo vaak op vragen als je wil. Filters geef je mee als queryparameter; een meerkeuzefilter scheid je met komma's.
curl -H "x-api-key: $SLEUTEL" \
"https://mijnb2bdata.nl/v1/tellen?provincies=Utrecht,Flevoland&mw_min=10"
{ "treffers": 78681, "geschat": false }
Met een straal: /v1/tellen?straal_pc=3511LN&straal_km=15 telt alles binnen
15 kilometer van die postcode.
Eén bedrijf. kvk mag acht cijfers zijn (dan krijg je de hoofdvestiging), twaalf
cijfers, of een vestigingsnummer.
curl -H "x-api-key: $SLEUTEL" \
"https://mijnb2bdata.nl/v1/bedrijf?kvk=33002587"
{ "bedrijf": {
"bedrijfsnaam": "NatWest Markets N.V.",
"kvk": "330025870000", "kvk_nummer": "33002587",
"vestigingsnummer": "000020381977",
"postcode": "1082MD", "plaatsnaam": "Amsterdam", "provincie": "Noord-Holland",
"sbi": "6419", "sbi_omschrijving": "Overige geldscheppende financiële instellingen",
"medewerkers_kl": "6: 100 tot 199",
"telefoonnummer": "+31204642699", "emailadres": null, "website": null,
"linkedin_url": "https://www.linkedin.com/company/natwest",
"kl_totaal": null } }
Niet gevonden geeft 404.
Zoeken met dezelfde filters als het scherm. Hoogstens 1000 rijen per verzoek; met
offset blader je verder. Zonder limit krijg je er vijftig.
curl -X POST -H "x-api-key: $SLEUTEL" -H "content-type: application/json" \
https://mijnb2bdata.nl/v1/zoek \
-d '{"filters":{"provincies":["Utrecht"],"mw_min":50,"vracht_min":3},"limit":100}'
{ "aantal": 100, "limit": 100, "offset": 0, "rijen": [ … ] }
Wil je eerst weten hoe groot het is, vraag dan /v1/tellen met hetzelfde filter.
Dat kost niets.
De naam van de contactpersoon van een bedrijf staat in contactpersoon_titel,
contactpersoon_voornaam en contactpersoon_achternaam. Dat is de
persoon die bij het bedrijf geregistreerd staat, niet per se de directeur.
Je eigen lijst nummers erin, volledige regels eruit. Acht cijfers is een KVK-nummer,
twaalf een vestigingsnummer; beide mogen door elkaar in dezelfde lijst. Hoogstens 10.000
per verzoek. Wat wij niet kennen komt terug in niet_gevonden en kost niets.
curl -X POST -H "x-api-key: $SLEUTEL" -H "content-type: application/json" \
https://mijnb2bdata.nl/v1/verrijk \
-d '{"sleutels":["33002587","000020381977","00000001"]}'
{ "gevraagd": 3, "gevonden": 2, "niet_gevonden": ["00000001"], "rijen": [ … ] }
Elke rij begint met sleutel: het nummer zoals jij het aanleverde. Zo leg je het
antwoord naast je eigen bestand zonder te hoeven zoeken welke regel bij welke hoort.
De namen van alle filters die wij aannemen, gesplitst in meerkeuze en enkelvoudig. Handig om te controleren of je een naam goed hebt: een filter dat wij niet kennen wordt stilzwijgend genegeerd, en dan krijg je te veel rijen in plaats van een foutmelding.
De geldige waarden van een keuzefilter. Een waarde moet precies overeenkomen, met
hoofdletters en al: een gemeente heet bij ons 363: Amsterdam, niet
Amsterdam. Een waarde die niet bestaat wordt geweigerd met 400;
in het antwoord staat dan welke waarde het is en wat er wel op lijkt.
curl -H "x-api-key: $SLEUTEL" \
"https://mijnb2bdata.nl/v1/waarden?filter=provincies"
{ "filter": "provincies", "aantal": 12, "waarden": [ "Zuid-Holland", "Noord-Holland", … ] }
Zonder filter krijg je de namen van de filters waar een vaste lijst bij hoort.
Merk, opbouw, segment en kleur hebben geen vaste lijst en worden niet gecontroleerd.
Een meerkeuzefilter geef je als lijst, of als object met mode om hem om te draaien:
"provincies": ["Utrecht", "Flevoland"]
"provincies": { "mode": "not", "v": ["Limburg"] }
De meest gebruikte:
| Filter | Soort | Wat het doet |
|---|---|---|
q | tekst | Zoekt in bedrijfsnaam, plaats en adres |
provincies, gemeenten, plaatsen | meerkeuze | Plaatsbepaling |
pc4_van, pc4_tot | getal | Postcodegebied van en tot |
straal | object | Binnen een aantal kilometer van een postcode, als {"pc":"3511LN","km":15}. Vier of zes posities, 1 tot 250 km. In plaats van een postcode mag ook {"lat":52.09,"lon":5.12,"km":15}. Bij GET /v1/tellen geef je straal_pc en straal_km mee. Een onbekende postcode geeft een 400. Vestigingen zonder coördinaat (zo'n 0,3 procent) vallen nooit binnen een straal |
sbi1 t/m sbi4 | meerkeuze | Sector volgens de SBI 2025, van sectie (een letter) naar klasse (vier cijfers) |
mw_min, mw_max | getal | Aantal medewerkers |
vracht_min, bedrijfs_min, personen_min, bus_min | getal | Minstens zoveel voertuigen van die soort |
totaal_min, totaal_max | getal | Omvang van het hele wagenpark |
heeft_telefoon, heeft_email, heeft_website, heeft_linkedin, heeft_contactpersoon | ja/nee | Alleen bedrijven waar dat bij staat |
excl_nonmailing | ja/nee | Laat bedrijven met een non-mailingvlag weg |
hoofdvestiging, uniek_concern | ja/nee | Eén regel per bedrijf in plaats van per vestiging |
opgericht_van, opgericht_tot | datum | Oprichtingsdatum, als 2020-01-01 |
ids | meerkeuze | Precies deze vestigingsnummers, verder niets |
De volledige lijst haal je op met /v1/filters, of je bouwt de selectie in het scherm
en leest de filters af aan de chips boven de tabel.
Rijen die het pand uit gaan tellen mee voor de exportlimiet van je abonnement, precies
zoals een export in het scherm. Eén rij is één vestiging. Tellen en de filterlijst zijn
gratis. Bij Account zie je per moment waar het verbruik vandaan komt: de API
staat er als zoek, bedrijf of verrijk.
Vraag eerst /v1/tellen en dan pas /v1/zoek. Dat scheelt je een selectie
van tienduizend rijen die je achteraf toch weggooit, en tellen kost niets.
| Code | Wat er aan de hand is |
|---|---|
400 | Verzoek klopt niet: een veld ontbreekt, de lijst is te lang, of een waarde in een keuzefilter bestaat niet. In dat laatste geval staat in onbekend welke waarde het is |
401 | Geen sleutel meegestuurd, of de sleutel is ingetrokken |
402 | Exportlimiet van deze maand bereikt. Er is niets afgeschreven |
404 | Onbekend adres, of het bedrijf bestaat niet bij ons |
405 | Verkeerde methode: zoek en verrijk zijn POST |
429 | Te veel verzoeken in een minuut. Wacht het aantal seconden uit Retry-After en ga dan door |
500 | Aan onze kant. Probeer het zo nog eens |
Elke fout komt terug als JSON met een veld fout waarin in gewoon Nederlands staat
wat er mis is.
De gegevens zijn voor gebruik binnen je eigen organisatie. Doorverkopen of doorleveren aan
derden mag niet. Voor eenmanszaken, VOF's en maatschappen is vooraf toestemming nodig voordat
je ze belt; dat is wettelijk zo geregeld en staat los van waar de gegevens vandaan komen.
Bedrijven met een non-mailingvlag sluit je uit met excl_nonmailing. De volledige
voorwaarden staan op de voorpagina.
Aantallen voertuigen per bedrijf komen naar buiten als klasse en niet als getal. Zo is een voertuig nooit aan een bedrijf te koppelen. Optellingen over een hele selectie zijn wel gewone getallen.