[{"data":1,"prerenderedAt":300},["ShallowReactive",2],{"page:\u002Fapi":3},{"id":4,"title":5,"body":6,"description":292,"extension":293,"meta":294,"navigation":295,"path":296,"seo":297,"stem":298,"__hash__":299},"pages\u002Fapi.md","API",{"type":7,"value":8,"toc":289},"minimark",[9,24,63,82,162,182,209,270],[10,11,12,19],"page-head",{},[13,14,16],"template",{"v-slot:title":15},"",[17,18,5],"p",{},[13,20,21],{"v-slot:lead":15},[17,22,23],{},"Eén bedrijf per call, op zijn KVK-nummer of zijn domein. Terug als JSON.",[25,26,27,32,35,43,53],"page-section",{},[13,28,29],{"v-slot:title":15},[17,30,31],{},"Een bedrijf ophalen",[17,33,34],{},"Stuur een KVK-nummer en je krijgt het bedrijf terug: wat het doet en gebruikt, als vaste velden.",[17,36,37,38,42],{},"Veldnamen zijn Engels, in ",[39,40,41],"code",{},"snake_case",". De uitleg en de foutberichten zijn Nederlands.",[17,44,45,48,49,52],{},[39,46,47],{},"website"," is de hoofdsite van het bedrijf, ",[39,50,51],{},"websites"," zijn de domeinen die we bij het bedrijf kennen. Een lijst is een array, ook met één waarde erin.",[13,54,55],{"v-slot:proof":15},[56,57],"api-request",{":response":58,"caption":59,"method":60,"path":61,":scroll":62},"{\"kvk_number\":\"00000002\",\"name\":\"Voorbeeld B.V.\",\"legal_form\":\"bv\",\"active\":true,\"vat_number\":\"NL000000002B01\",\"address\":{\"street\":\"Voorbeeldstraat\",\"house_number\":\"1\",\"postcode\":\"3511AA\",\"city\":\"Utrecht\",\"country\":\"NL\",\"latitude\":52.0907,\"longitude\":5.1214},\"building\":{\"uses\":[\"kantoorfunctie\"],\"floor_area\":180,\"construction_year\":1931},\"website\":\"voorbeeld.nl\",\"websites\":[\"voorbeeld.nl\",\"voorbeeldbv.nl\"],\"languages\":[\"nl\",\"en\"],\"services\":[\"Advies\",\"Onderhoud\"],\"trust_marks\":[],\"rating\":null,\"apps\":[],\"webshop\":false,\"webshop_platform\":null,\"payment_providers\":[],\"payment_methods\":[],\"shipping_countries\":[],\"shipping_area\":null,\"phone\":\"+31301234567\",\"whatsapp\":null,\"email\":\"info@voorbeeld.nl\",\"social_profiles\":[{\"platform\":\"linkedin\",\"url\":\"https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Fvoorbeeld\"}],\"chat\":[],\"booking\":false,\"booking_tools\":[],\"opening_hours\":[{\"day\":\"monday\",\"opens\":\"09:00\",\"closes\":\"17:00\"},{\"day\":\"tuesday\",\"opens\":\"09:00\",\"closes\":\"17:00\"},{\"day\":\"wednesday\",\"opens\":\"09:00\",\"closes\":\"17:00\"},{\"day\":\"thursday\",\"opens\":\"09:00\",\"closes\":\"17:00\"},{\"day\":\"friday\",\"opens\":\"09:00\",\"closes\":\"17:00\"}],\"open_vacancies\":2,\"vacancies\":[{\"title\":\"Adviseur\",\"location\":\"Utrecht\",\"employment_type\":\"FULL_TIME\",\"url\":\"https:\u002F\u002Fvoorbeeld.nl\u002Fvacatures\u002Fadviseur\"},{\"title\":\"Office manager\",\"location\":\"Utrecht\",\"employment_type\":\"PART_TIME\",\"url\":\"https:\u002F\u002Fvoorbeeld.nl\u002Fvacatures\u002Foffice-manager\"}],\"technologies\":[{\"name\":\"Google Analytics\",\"category\":\"analytics\",\"version\":null,\"support\":null},{\"name\":\"WordPress\",\"category\":\"cms\",\"version\":\"6.9\",\"support\":\"current\"},{\"name\":\"Cookiebot\",\"category\":\"consent\",\"version\":null,\"support\":null}],\"cms\":\"WordPress\",\"outdated_software\":false,\"hosting\":{\"provider\":\"transip\",\"dns_provider\":\"transip\",\"cdn\":null,\"http3\":false},\"security_headers\":[\"strict-transport-security\",\"x-content-type-options\"],\"email_provider\":\"microsoft\",\"mail_security\":{\"spf\":\"softfail\",\"dmarc\":\"quarantine\",\"dkim\":true,\"bimi\":false,\"mta_sts\":false},\"cookie_banner\":true,\"consent_platform\":\"Cookiebot\",\"privacy_statement\":true,\"tracks_before_consent\":false,\"known\":{\"count\":35,\"total\":39,\"fields\":[\"legal_form\",\"active\",\"vat_number\",\"address\",\"building\",\"website\",\"websites\",\"languages\",\"services\",\"trust_marks\",\"apps\",\"webshop\",\"payment_providers\",\"payment_methods\",\"shipping_countries\",\"phone\",\"email\",\"social_profiles\",\"chat\",\"booking\",\"booking_tools\",\"opening_hours\",\"open_vacancies\",\"vacancies\",\"technologies\",\"cms\",\"outdated_software\",\"hosting\",\"security_headers\",\"email_provider\",\"mail_security\",\"cookie_banner\",\"consent_platform\",\"privacy_statement\",\"tracks_before_consent\"]}}","Voorbeeld met een fictief bedrijf.","GET","\u002Fv1\u002Fcompanies\u002F00000002","true",[25,64,65,70,73,76],{},[13,66,67],{"v-slot:title":15},[17,68,69],{},"Van nummer tot lijst",[17,71,72],{},"Het KVK-nummer komt eerst. Het domein is een gelijkwaardige tweede ingang: heb je alleen een website, bijvoorbeeld uit het e-mailadres bij een aanmelding, dan krijg je hetzelfde antwoord.",[17,74,75],{},"Daarna zoeken op wat bedrijven doen en gebruiken, en een lijst in één keer verrijken.",[13,77,78],{"v-slot:proof":15},[79,80],"endpoint-list",{":endpoints":81},"[{\"method\":\"GET\",\"path\":\"\u002Fv1\u002Fcompanies\u002F{kvk_number}\",\"description\":\"Eén bedrijf op zijn KVK-nummer.\"},{\"method\":\"GET\",\"path\":\"\u002Fv1\u002Fcompanies?domain=voorbeeld.nl\",\"description\":\"Hetzelfde bedrijf, op zijn domein.\"},{\"method\":\"GET\",\"path\":\"\u002Fv1\u002Fcompanies\",\"description\":\"Bedrijven zoeken op wat ze doen en gebruiken.\"},{\"method\":\"POST\",\"path\":\"\u002Fv1\u002Fcompanies\u002Fenrich\",\"description\":\"Een lijst KVK-nummers in één keer verrijken.\"}]",[25,83,84,92,98,109,139,154],{},[13,85,86],{"v-slot:title":15},[17,87,88,89],{},"Onbekend is ",[39,90,91],{},"null",[17,93,94,95,97],{},"Een veld dat we niet kennen, is ",[39,96,91],{},". Nooit een lege tekst en nooit een nul, zodat je het verschil ziet tussen nee en weten we niet.",[17,99,100,101,104,105,108],{},"Het object ",[39,102,103],{},"known"," telt de velden die we kennen. Een getal, geen tekst als ",[39,106,107],{},"\"6\u002F7\"",": dan kun je erop sorteren en filteren.",[110,111,112,119,133],"ul",{},[113,114,115,118],"li",{},[39,116,117],{},"count",": hoeveel velden we kennen.",[113,120,121,124,125,128,129,132],{},[39,122,123],{},"total",": hoeveel velden een antwoord heeft, zonder ",[39,126,127],{},"kvk_number"," en ",[39,130,131],{},"name",".",[113,134,135,138],{},[39,136,137],{},"fields",": de velden die we kennen.",[17,140,141,142,145,146,149,150,153],{},"Een ",[39,143,144],{},"false",", een ",[39,147,148],{},"0"," of een lege lijst ",[39,151,152],{},"[]"," is een antwoord, en telt mee als bekend.",[13,155,156],{"v-slot:proof":15},[157,158],"plain-table",{":code":159,":columns":160,":rows":161},"[1]","[\"Betekenis\",\"Waarde\"]","[[\"Bekend\",\"de waarde\"],[\"Nee, nul of geen\",\"false, 0 of []\"],[\"Onbekend\",\"null\"]]",[25,163,164,169,175],{},[13,165,166],{"v-slot:title":15},[17,167,168],{},"Notatie",[17,170,171,172,132],{},"Waarden komen in een vaste vorm, zodat je ze zonder omrekenen opslaat. Hoe je ze toont, kies je zelf: de app laat een telefoonnummer zien als ",[39,173,174],{},"030 123 45 67",[13,176,177],{"v-slot:proof":15},[157,178],{":code":179,":columns":180,":rows":181},"[2]","[\"Veld\",\"Vorm\",\"Voorbeeld\"]","[[\"Telefoon\",\"E.164\",\"+31301234567\"],[\"Postcode\",\"zonder spatie\",\"3511AA\"],[\"Land\",\"ISO 3166-1\",\"NL\"],[\"Rechtsvorm, providers\",\"code in kleine letters\",\"bv\"],[\"Bedrag\",\"centen, met currency\",\"4900\"],[\"Datum\",\"ISO 8601\",\"2026-10-20\"]]",[25,183,184,189,203],{},[13,185,186],{"v-slot:title":15},[17,187,188],{},"Je API-sleutel",[17,190,191,192,195,196,132],{},"Stuur je sleutel mee in de header ",[39,193,194],{},"Authorization: Bearer \u003Csleutel>",". Je maakt je sleutels zelf, in ",[197,198,202],"a",{"href":199,"rel":200},"https:\u002F\u002Fapp.achtcijfers.nl\u002Fsignup",[201],"nofollow","je account",[17,204,205,206,132],{},"Per sleutel kun je [aantal] verzoeken per minuut doen. Daarboven krijg je de fout ",[39,207,208],{},"rate_limited",[25,210,211,216,234,263],{},[13,212,213],{"v-slot:title":15},[17,214,215],{},"Fouten",[17,217,218,219,222,223,225,226,229,230,233],{},"Een fout heeft steeds dezelfde vorm: een object ",[39,220,221],{},"error"," met een ",[39,224,39],{}," om in je code op te reageren, een ",[39,227,228],{},"message"," in het Nederlands en een ",[39,231,232],{},"docs_url"," naar de uitleg hieronder.",[110,235,236,242,248,254],{},[113,237,238,241],{},[39,239,240],{"id":240},"invalid_api_key"," (401): de sleutel ontbreekt, of we kennen hem niet. Misschien is hij ingetrokken.",[113,243,244,247],{},[39,245,246],{"id":246},"invalid_kvk_number"," (422): een KVK-nummer heeft acht cijfers, zonder spaties of punten.",[113,249,250,253],{},[39,251,252],{"id":252},"company_unknown"," (404): we kennen het nummer niet. Dat zegt niets over het bedrijf.",[113,255,256,258,259,262],{},[39,257,208],{"id":208}," (429): de sleutel zit aan zijn limiet. De header ",[39,260,261],{},"Retry-After"," zegt na hoeveel seconden je het opnieuw kunt proberen.",[13,264,265],{"v-slot:proof":15},[56,266],{":response":267,"caption":268,"method":60,"path":269},"{\"error\":{\"code\":\"company_unknown\",\"message\":\"We kennen KVK-nummer 00000001 niet. Dat zegt niets over het bedrijf.\",\"docs_url\":\"https:\u002F\u002Fachtcijfers.nl\u002Fapi#company_unknown\"}}","Voorbeeld met een fictief nummer dat we niet kennen.","\u002Fv1\u002Fcompanies\u002F00000001",[25,271,272,277],{},[13,273,274],{"v-slot:title":15},[17,275,276],{},"Wat je per call krijgt",[17,278,279,280,284,285,132],{},"Hoeveel velden een antwoord heeft, kies je met het pakket: Basis, Plus of Tech. Welk veld in welk pakket zit, staat op ",[197,281,283],{"href":282},"\u002Fvelden","Velden",". Je betaalt per bedrijf, en een nummer dat we niet kennen kost niets. ",[197,286,288],{"href":287},"\u002Fprijzen","Naar de prijzen",{"title":15,"searchDepth":290,"depth":290,"links":291},2,[],"Haal een bedrijf op met zijn KVK-nummer of zijn domein, en krijg wat het doet en gebruikt terug als JSON.","md",{},true,"\u002Fapi",{"title":5,"description":292},"api","PD1-D59BQJ-jzmdGSKBOXaglQ7Yfin6hBvUgsE6p-B0",1793465540702]