Query parameters
name is required: at least 3 characters after trimming. limit is optional: default 20, minimum 1, maximum 100. Fuzzy matching returns candidates; it does not prove identity. Authentication: X-Api-Key.
curl --get 'https://api.companyapi.be/companies' \
--data-urlencode 'name=Colruyt' \
--data-urlencode 'limit=5' \
--header "X-Api-Key: $COMPANYAPI_KEY"Response
200 returns an array of basic company objects. No matches produces an empty array, not 404. Names come from available, non-deleted denominations. Select the correct enterprise number before requesting extended details.
Status and limits
400: missing/short name or limit outside 1–100. 401: authentication failure. 429: rate limit reached. Plan limits apply to the request, not the number of returned matches.
Basic company information
| Field | Meaning | Availability |
|---|---|---|
enterpriseNumber | Company enterprise number, as stored in the registry snapshot. | Present |
vatNumber | BE-prefixed enterprise number; not a VAT validity check. | Can be null |
name | Selected company denomination. | Can be null |
status | Registry status code and available descriptions. | Present |
juridicalSituation | Legal situation code and available descriptions. | Present |
typeOfEnterprise | Type of enterprise. | Present |
juridicalForm | Legal form. | Can be null |
juridicalFormCAC | Legal form under the Companies and Associations Code. | Can be null |
startDate | Registry start date. | Present |
Illustrative response
[
{
"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"
}
]Sample data, not a live lookup. Dates and field values are illustrative.
