Request
Use the same checksum-valid number formats as basic lookup. Authentication: X-Api-Key. One successful extended call counts as one request.
curl 'https://api.companyapi.be/companies/0801523965/extended' \
--header "X-Api-Key: $COMPANYAPI_KEY"Response collections
The basic company object is extended with establishments, branches, denominations, addresses, contacts and activities. Collections may be empty. Child rows carry their entityNumber so company and establishment details can be distinguished.
Use codes carefully
Language, address/contact types and NACE values use coded objects with available descriptions. Preserve codes and NACE versions. Descriptions are not guaranteed in every language. 400, 401, 404 and 429 have the same meanings as basic lookup.
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 |
Extended registry information
| Field | Meaning | Availability |
|---|---|---|
establishments | Establishment numbers and their start dates. | Can be empty |
branches | Branch identifiers and start dates. | Can be empty |
denominations | Names with entity number, language and denomination type. | Can be empty |
addresses | Available country, postcode, municipality, street, house/box and address type. | Can be empty |
contacts | Available contact values with contact type and linked entity. | Can be empty |
activities | NACE version/code, activity group, classification and linked entity. | Can be empty |
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",
"establishments": [],
"branches": [],
"denominations": [],
"addresses": [],
"contacts": [],
"activities": []
}Sample data, not a live lookup. Dates and field values are illustrative.
Inside the extended response
Field names are unchanged across languages. The schema comes from the public API contract. Nested records originate from the available KBO/BCE snapshot.
CodedValueResponse
| Field | Meaning | Availability |
|---|---|---|
codestring | Raw registry code. | Present |
descriptionsobject | Source descriptions keyed by lowercase language code; may be empty. | Can be empty |
EstablishmentResponse
| Field | Meaning | Availability |
|---|---|---|
establishmentNumberstring | Establishment identifier. | Present |
startDatedate | Start date recorded in the source. | Present |
BranchResponse
| Field | Meaning | Availability |
|---|---|---|
idstring | Branch identifier. | Present |
startDatedate | Start date recorded in the source. | Present |
DenominationResponse
| Field | Meaning | Availability |
|---|---|---|
entityNumberstring | Enterprise, establishment or branch linked to this row. | Present |
languageCodedValueResponse | Language code and available labels. | Present |
typeOfDenominationCodedValueResponse | Denomination type code and labels. | Present |
valuestring | Name or contact value. | Present |
AddressResponse
| Field | Meaning | Availability |
|---|---|---|
entityNumberstring | Enterprise, establishment or branch linked to this row. | Present |
typeOfAddressCodedValueResponse | Address type code and labels. | Present |
countryNLstring | Country label in Dutch. | Can be null |
countryFRstring | Country label in French. | Can be null |
zipcodestring | Postal code. | Can be null |
municipalityNLstring | Municipality in Dutch. | Can be null |
municipalityFRstring | Municipality in French. | Can be null |
streetNLstring | Street in Dutch. | Can be null |
streetFRstring | Street in French. | Can be null |
houseNumberstring | House number. | Can be null |
boxstring | Box or unit. | Can be null |
extraAddressInfostring | Additional address information. | Can be null |
dateStrikingOffdate | Address striking-off date, when available. | Can be null |
ContactResponse
| Field | Meaning | Availability |
|---|---|---|
entityNumberstring | Enterprise, establishment or branch linked to this row. | Present |
entityContactCodedValueResponse | Contact entity category and labels. | Present |
contactTypeCodedValueResponse | Contact channel type and labels. | Present |
valuestring | Name or contact value. | Present |
ActivityResponse
| Field | Meaning | Availability |
|---|---|---|
entityNumberstring | Enterprise, establishment or branch linked to this row. | Present |
activityGroupCodedValueResponse | Activity group code and labels. | Present |
naceVersionstring | NACE classification version. | Present |
naceCodeCodedValueResponse | Activity code and available descriptions. | Present |
classificationCodedValueResponse | Activity classification code and labels. | Present |
