COMPANYAPI

Vraag uitgebreide bedrijfsgegevens op.

GET /companies/{number}/extended voegt registerlijsten toe.

Verzoek

Dezelfde geldige nummerformaten als bij basisopzoeking. Authenticatie: X-Api-Key. Eén geslaagde uitgebreide opzoeking telt als één verzoek.

cURL
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

VeldBetekenisBeschikbaarheid
enterpriseNumberOndernemingsnummer zoals opgeslagen in de registersnapshot.Aanwezig
vatNumberOndernemingsnummer met BE-prefix; geen btw-geldigheidscontrole.Kan null zijn
nameGeselecteerde bedrijfsbenaming.Kan null zijn
statusRegisterstatus met beschikbare omschrijvingen.Aanwezig
juridicalSituationRechtstoestand met beschikbare omschrijvingen.Aanwezig
typeOfEnterpriseType onderneming.Aanwezig
juridicalFormRechtsvorm.Kan null zijn
juridicalFormCACRechtsvorm volgens het Wetboek van vennootschappen en verenigingen.Kan null zijn
startDateStartdatum in het register.Aanwezig

Uitgebreide registergegevens

VeldBetekenisBeschikbaarheid
establishmentsVestigingsnummers en startdatums.Kan leeg zijn
branchesBijkantooridentificaties en startdatums.Kan leeg zijn
denominationsNamen met entiteitsnummer, taal en type.Kan leeg zijn
addressesBeschikbaar land, postcode, gemeente, straat, huis/bus en adrestype.Kan leeg zijn
contactsBeschikbare contactwaarden met type en gekoppelde entiteit.Kan leeg zijn
activitiesNACE-versie/code, activiteitengroep, classificatie en entiteit.Kan leeg zijn

Illustratief antwoord

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": []
}

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
VeldBetekenisBeschikbaarheid
codestringRuwe registercode.Aanwezig
descriptionsobjectBronomschrijvingen met taalcodes in kleine letters; kan leeg zijn.Kan leeg zijn
EstablishmentResponse
VeldBetekenisBeschikbaarheid
establishmentNumberstringVestigingsidentificatie.Aanwezig
startDatedateStartdatum in de bron.Aanwezig
BranchResponse
VeldBetekenisBeschikbaarheid
idstringBijkantooridentificatie.Aanwezig
startDatedateStartdatum in de bron.Aanwezig
DenominationResponse
VeldBetekenisBeschikbaarheid
entityNumberstringOnderneming, vestiging of bijkantoor bij deze rij.Aanwezig
languageCodedValueResponseTaalcode en beschikbare omschrijvingen.Aanwezig
typeOfDenominationCodedValueResponseType benaming met omschrijvingen.Aanwezig
valuestringNaam of contactwaarde.Aanwezig
AddressResponse
VeldBetekenisBeschikbaarheid
entityNumberstringOnderneming, vestiging of bijkantoor bij deze rij.Aanwezig
typeOfAddressCodedValueResponseAdrestype met omschrijvingen.Aanwezig
countryNLstringLand in het Nederlands.Kan null zijn
countryFRstringLand in het Frans.Kan null zijn
zipcodestringPostcode.Kan null zijn
municipalityNLstringGemeente in het Nederlands.Kan null zijn
municipalityFRstringGemeente in het Frans.Kan null zijn
streetNLstringStraat in het Nederlands.Kan null zijn
streetFRstringStraat in het Frans.Kan null zijn
houseNumberstringHuisnummer.Kan null zijn
boxstringBus of eenheid.Kan null zijn
extraAddressInfostringAanvullende adresinformatie.Kan null zijn
dateStrikingOffdateSchrappingsdatum van het adres, indien beschikbaar.Kan null zijn
ContactResponse
VeldBetekenisBeschikbaarheid
entityNumberstringOnderneming, vestiging of bijkantoor bij deze rij.Aanwezig
entityContactCodedValueResponseCategorie contactentiteit met omschrijvingen.Aanwezig
contactTypeCodedValueResponseType contactkanaal met omschrijvingen.Aanwezig
valuestringNaam of contactwaarde.Aanwezig
ActivityResponse
VeldBetekenisBeschikbaarheid
entityNumberstringOnderneming, vestiging of bijkantoor bij deze rij.Aanwezig
activityGroupCodedValueResponseActiviteitengroep met omschrijvingen.Aanwezig
naceVersionstringVersie van de NACE-classificatie.Aanwezig
naceCodeCodedValueResponseActiviteitscode en beschikbare omschrijvingen.Aanwezig
classificationCodedValueResponseActiviteitsclassificatie met omschrijvingen.Aanwezig

COMPANYAPI

Bouw je volgende verbinding.

Begin met een gratis API-sleutel. Geef je applicatie een betere basis.

API-sleutel aanvragen

We bewaren je privacykeuze. Met je toestemming onthouden we je taal, meten we bezoeken met Umami en registreren we interacties voor sessieopnames en heatmaps. Elk optioneel doel staat uit tot je kiest.

Geen advertentietrackers. Wijzig of trek je keuzes altijd in via Cookievoorkeuren.