1. Maak een werkruimte en sleutel
Doorloop de onboarding, kies een abonnement, verifieer je e-mail en maak een API-sleutel. Bewaar het geheim veilig; het wordt bij het aanmaken getoond.
2. Verstuur een serververzoek
Stel COMPANYAPI_KEY in op je server. Zoek op naam met de X-Api-Key-header. Dit voorbeeld geeft een lijst mogelijke matches terug.
curl --get 'https://api.companyapi.be/companies' \
--data-urlencode 'name=Colruyt' \
--data-urlencode 'limit=5' \
--header "X-Api-Key: $COMPANYAPI_KEY"3. Vraag details op
Kies een ondernemingsnummer en vraag het uitgebreide record op voor beschikbare adressen, contacten en activiteiten. Basisopzoeking geeft identiteit en rechtsgegevens.
curl 'https://api.companyapi.be/companies/0801523965/extended' \
--header "X-Api-Key: $COMPANYAPI_KEY"4. Verwerk verschillende antwoorden
Onderscheid 400 invoerfouten, 401 authenticatie, 404 niet gevonden en 429 begrenzing. Stel je sleutel niet bloot in een browser of logbestand.
Illustratief antwoord
{
"enterpriseNumber": "0801.523.965",
"vatNumber": "BE0801.523.965",
"name": "Nyffels",
"status": { "code": "AC", "descriptions": {} },
"juridicalSituation": { "code": "000", "descriptions": {} },
"typeOfEnterprise": { "code": "2", "descriptions": {} },
"juridicalForm": null,
"juridicalFormCAC": null,
"startDate": "2023-05-01"
}Voorbeeldgegevens, geen live opzoeking. Datums en veldwaarden zijn illustratief.
