COMPANYAPI

Zoek een bedrijf op nummer.

GET /companies/{number} geeft beschikbare basisgegevens.

Verzoek

number is verplicht: tien cijfers met geldig controlegetal. Punten en een BE-prefix worden ondersteund. Authenticatie: X-Api-Key.

cURL
curl 'https://api.companyapi.be/companies/0801523965' \
  --header "X-Api-Key: $COMPANYAPI_KEY"

Antwoord

200 geeft enterpriseNumber, vatNumber, name, status, juridicalSituation, typeOfEnterprise, juridicalForm, juridicalFormCAC en startDate. Geen adressen in het basisantwoord.

Status en limieten

400: ongeldig nummer. 401: authenticatiefout. 404: geen beschikbaar bedrijf. 429: minuutlimiet. Klantlimieten gelden. Verwijderde records worden uitgesloten; inactieve bedrijven kunnen terugkomen.

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

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"
}

Voorbeeldgegevens, geen live opzoeking. Datums en veldwaarden zijn illustratief.

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.