COMPANYAPI

Je eerste CompanyAPI-verzoek.

Van onboarding naar gestructureerde Belgische bedrijfsgegevens.

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
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
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

JSON
{
  "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.

Documentatie

COMPANYAPI

Bouw je volgende verbinding.

Begin met een gratis API-sleutel. Geef je applicatie een betere basis.

API-sleutel aanvragen

We bewaren je privacykeuze. Met je toestemming onthouden we je taal, meten we bezoeken met Umami en registreren we interacties voor sessieopnames en heatmaps. Elk optioneel doel staat uit tot je kiest.

Geen advertentietrackers. Wijzig of trek je keuzes altijd in via Cookievoorkeuren.