Queryparameters
name is verplicht: minimaal 3 tekens na trimmen. limit is optioneel: standaard 20, minimum 1, maximum 100. Fuzzy zoeken bewijst geen identiteit. Authenticatie: X-Api-Key.
curl --get 'https://api.companyapi.be/companies' \
--data-urlencode 'name=Colruyt' \
--data-urlencode 'limit=5' \
--header "X-Api-Key: $COMPANYAPI_KEY"Antwoord
200 geeft een lijst basisrecords. Geen matches geeft een lege lijst, geen 404. Namen komen uit beschikbare niet-verwijderde benamingen. Kies het juiste nummer voor je details opvraagt.
Status en limieten
400: ontbrekende/korte naam of limit buiten 1–100. 401: authenticatiefout. 429: minuutlimiet. De bundel telt verzoeken, niet het aantal resultaten.
Basisgegevens
| Veld | Betekenis | Beschikbaarheid |
|---|---|---|
enterpriseNumber | Ondernemingsnummer zoals opgeslagen in de registersnapshot. | Aanwezig |
vatNumber | Ondernemingsnummer met BE-prefix; geen btw-geldigheidscontrole. | Kan null zijn |
name | Geselecteerde bedrijfsbenaming. | Kan null zijn |
status | Registerstatus met beschikbare omschrijvingen. | Aanwezig |
juridicalSituation | Rechtstoestand met beschikbare omschrijvingen. | Aanwezig |
typeOfEnterprise | Type onderneming. | Aanwezig |
juridicalForm | Rechtsvorm. | Kan null zijn |
juridicalFormCAC | Rechtsvorm volgens het Wetboek van vennootschappen en verenigingen. | Kan null zijn |
startDate | Startdatum in het register. | Aanwezig |
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.
