COMPANYAPI

Retrieve extended company data.

GET /companies/{number}/extended adds available registry collections.

Request

Use the same checksum-valid number formats as basic lookup. Authentication: X-Api-Key. One successful extended call counts as one request.

cURL
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

FieldMeaningAvailability
enterpriseNumberCompany enterprise number, as stored in the registry snapshot.Present
vatNumberBE-prefixed enterprise number; not a VAT validity check.Can be null
nameSelected company denomination.Can be null
statusRegistry status code and available descriptions.Present
juridicalSituationLegal situation code and available descriptions.Present
typeOfEnterpriseType of enterprise.Present
juridicalFormLegal form.Can be null
juridicalFormCACLegal form under the Companies and Associations Code.Can be null
startDateRegistry start date.Present

Extended registry information

FieldMeaningAvailability
establishmentsEstablishment numbers and their start dates.Can be empty
branchesBranch identifiers and start dates.Can be empty
denominationsNames with entity number, language and denomination type.Can be empty
addressesAvailable country, postcode, municipality, street, house/box and address type.Can be empty
contactsAvailable contact values with contact type and linked entity.Can be empty
activitiesNACE version/code, activity group, classification and linked entity.Can be empty

Illustrative response

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",
  "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
FieldMeaningAvailability
codestringRaw registry code.Present
descriptionsobjectSource descriptions keyed by lowercase language code; may be empty.Can be empty
EstablishmentResponse
FieldMeaningAvailability
establishmentNumberstringEstablishment identifier.Present
startDatedateStart date recorded in the source.Present
BranchResponse
FieldMeaningAvailability
idstringBranch identifier.Present
startDatedateStart date recorded in the source.Present
DenominationResponse
FieldMeaningAvailability
entityNumberstringEnterprise, establishment or branch linked to this row.Present
languageCodedValueResponseLanguage code and available labels.Present
typeOfDenominationCodedValueResponseDenomination type code and labels.Present
valuestringName or contact value.Present
AddressResponse
FieldMeaningAvailability
entityNumberstringEnterprise, establishment or branch linked to this row.Present
typeOfAddressCodedValueResponseAddress type code and labels.Present
countryNLstringCountry label in Dutch.Can be null
countryFRstringCountry label in French.Can be null
zipcodestringPostal code.Can be null
municipalityNLstringMunicipality in Dutch.Can be null
municipalityFRstringMunicipality in French.Can be null
streetNLstringStreet in Dutch.Can be null
streetFRstringStreet in French.Can be null
houseNumberstringHouse number.Can be null
boxstringBox or unit.Can be null
extraAddressInfostringAdditional address information.Can be null
dateStrikingOffdateAddress striking-off date, when available.Can be null
ContactResponse
FieldMeaningAvailability
entityNumberstringEnterprise, establishment or branch linked to this row.Present
entityContactCodedValueResponseContact entity category and labels.Present
contactTypeCodedValueResponseContact channel type and labels.Present
valuestringName or contact value.Present
ActivityResponse
FieldMeaningAvailability
entityNumberstringEnterprise, establishment or branch linked to this row.Present
activityGroupCodedValueResponseActivity group code and labels.Present
naceVersionstringNACE classification version.Present
naceCodeCodedValueResponseActivity code and available descriptions.Present
classificationCodedValueResponseActivity classification code and labels.Present

COMPANYAPI

Build your next connection.

Start with a free API key. Give your application a better foundation.

Get an API key

We save your privacy choice. With your permission, we remember your language, measure visits with Umami, and record interactions for session replays and heatmaps. Each optional purpose is off until you choose.

No advertising trackers. Change or withdraw your choices at any time using Cookie preferences.