Verzoek
Dezelfde geldige nummerformaten als bij basisopzoeking. Authenticatie: X-Api-Key. Eén geslaagde uitgebreide opzoeking telt als één verzoek.
curl 'https://api.companyapi.be/companies/0801523965/extended' \
--header "X-Api-Key: $COMPANYAPI_KEY"Lijsten in het antwoord
Toegevoegd aan de basis: establishments, branches, denominations, addresses, contacts en activities. Lijsten kunnen leeg zijn. Onderliggende records bevatten entityNumber om onderneming en vestiging te onderscheiden.
Gebruik codes zorgvuldig
Taal, adres/contacttype en NACE gebruiken codeobjecten met beschikbare omschrijvingen. Bewaar code en NACE-versie. Niet elke taal is beschikbaar. Statussen 400, 401, 404 en 429 werken zoals bij basisopzoeking.
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 |
Uitgebreide registergegevens
| Veld | Betekenis | Beschikbaarheid |
|---|---|---|
establishments | Vestigingsnummers en startdatums. | Kan leeg zijn |
branches | Bijkantooridentificaties en startdatums. | Kan leeg zijn |
denominations | Namen met entiteitsnummer, taal en type. | Kan leeg zijn |
addresses | Beschikbaar land, postcode, gemeente, straat, huis/bus en adrestype. | Kan leeg zijn |
contacts | Beschikbare contactwaarden met type en gekoppelde entiteit. | Kan leeg zijn |
activities | NACE-versie/code, activiteitengroep, classificatie en entiteit. | Kan leeg zijn |
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",
"establishments": [],
"branches": [],
"denominations": [],
"addresses": [],
"contacts": [],
"activities": []
}Voorbeeldgegevens, geen live opzoeking. Datums en veldwaarden zijn illustratief.
Binnen het uitgebreide antwoord
Veldnamen blijven gelijk in elke taal. Het schema komt uit het publieke API-contract. Onderliggende records komen uit de beschikbare KBO/BCE-snapshot.
CodedValueResponse
| Veld | Betekenis | Beschikbaarheid |
|---|---|---|
codestring | Ruwe registercode. | Aanwezig |
descriptionsobject | Bronomschrijvingen met taalcodes in kleine letters; kan leeg zijn. | Kan leeg zijn |
EstablishmentResponse
| Veld | Betekenis | Beschikbaarheid |
|---|---|---|
establishmentNumberstring | Vestigingsidentificatie. | Aanwezig |
startDatedate | Startdatum in de bron. | Aanwezig |
BranchResponse
| Veld | Betekenis | Beschikbaarheid |
|---|---|---|
idstring | Bijkantooridentificatie. | Aanwezig |
startDatedate | Startdatum in de bron. | Aanwezig |
DenominationResponse
| Veld | Betekenis | Beschikbaarheid |
|---|---|---|
entityNumberstring | Onderneming, vestiging of bijkantoor bij deze rij. | Aanwezig |
languageCodedValueResponse | Taalcode en beschikbare omschrijvingen. | Aanwezig |
typeOfDenominationCodedValueResponse | Type benaming met omschrijvingen. | Aanwezig |
valuestring | Naam of contactwaarde. | Aanwezig |
AddressResponse
| Veld | Betekenis | Beschikbaarheid |
|---|---|---|
entityNumberstring | Onderneming, vestiging of bijkantoor bij deze rij. | Aanwezig |
typeOfAddressCodedValueResponse | Adrestype met omschrijvingen. | Aanwezig |
countryNLstring | Land in het Nederlands. | Kan null zijn |
countryFRstring | Land in het Frans. | Kan null zijn |
zipcodestring | Postcode. | Kan null zijn |
municipalityNLstring | Gemeente in het Nederlands. | Kan null zijn |
municipalityFRstring | Gemeente in het Frans. | Kan null zijn |
streetNLstring | Straat in het Nederlands. | Kan null zijn |
streetFRstring | Straat in het Frans. | Kan null zijn |
houseNumberstring | Huisnummer. | Kan null zijn |
boxstring | Bus of eenheid. | Kan null zijn |
extraAddressInfostring | Aanvullende adresinformatie. | Kan null zijn |
dateStrikingOffdate | Schrappingsdatum van het adres, indien beschikbaar. | Kan null zijn |
ContactResponse
| Veld | Betekenis | Beschikbaarheid |
|---|---|---|
entityNumberstring | Onderneming, vestiging of bijkantoor bij deze rij. | Aanwezig |
entityContactCodedValueResponse | Categorie contactentiteit met omschrijvingen. | Aanwezig |
contactTypeCodedValueResponse | Type contactkanaal met omschrijvingen. | Aanwezig |
valuestring | Naam of contactwaarde. | Aanwezig |
ActivityResponse
| Veld | Betekenis | Beschikbaarheid |
|---|---|---|
entityNumberstring | Onderneming, vestiging of bijkantoor bij deze rij. | Aanwezig |
activityGroupCodedValueResponse | Activiteitengroep met omschrijvingen. | Aanwezig |
naceVersionstring | Versie van de NACE-classificatie. | Aanwezig |
naceCodeCodedValueResponse | Activiteitscode en beschikbare omschrijvingen. | Aanwezig |
classificationCodedValueResponse | Activiteitsclassificatie met omschrijvingen. | Aanwezig |
