COMPANYAPI

Zoek op bedrijfsnaam.

GET /companies?name={name}&limit={limit} geeft mogelijke overeenkomsten.

Queryparameters

name is verplicht: minimaal 3 tekens na trimmen. limit is optioneel: standaard 20, minimum 1, maximum 100. Fuzzy zoeken bewijst geen identiteit. Authenticatie: X-Api-Key.

cURL
curl --get 'https://api.companyapi.be/companies' \
  --data-urlencode 'name=Colruyt' \
  --data-urlencode 'limit=5' \
  --header "X-Api-Key: $COMPANYAPI_KEY"

Antwoord

200 geeft een lijst basisrecords. Geen matches geeft een lege lijst, geen 404. Namen komen uit beschikbare niet-verwijderde benamingen. Kies het juiste nummer voor je details opvraagt.

Status en limieten

400: ontbrekende/korte naam of limit buiten 1–100. 401: authenticatiefout. 429: minuutlimiet. De bundel telt verzoeken, niet het aantal resultaten.

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.