Request
Required path parameter: number. Accepts a checksum-valid ten-digit enterprise number, including dotted or BE-prefixed input. Authentication: X-Api-Key.
curl 'https://api.companyapi.be/companies/0801523965' \
--header "X-Api-Key: $COMPANYAPI_KEY"Response
200 returns one company object with enterpriseNumber, vatNumber, name, status, juridicalSituation, typeOfEnterprise, juridicalForm, juridicalFormCAC and startDate. Basic lookup does not return addresses.
Status and limits
400: malformed or invalid checksum. 401: authentication failure. 404: no available company. 429: rate limit reached. Client rate limits apply. A deleted record is excluded; an inactive company may still be returned.
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.
