Onderneming

Endpoints voor de resource Onderneming. Alle calls vereisen authenticatie en geven de standaard JSON-envelope terug.

🔗

Basis-URL: https://companybelgium.be/api/v2 · Authenticatie

Retrieve enterprise details#

GET/enterprise/{num}

Full record for a single enterprise: status, juridical form, start date, denominations, registered office and primary activity.

Parameters

Naam	In/Type	Verplicht	Omschrijving
`num`	path string	Verplicht	Enterprise number (BCE/KBO), e.g. 0403.170.701. Dots optional.

Verzoek

curl https://companybelgium.be/api/v2/enterprise/0403.170.701 \
  -H "X-API-Key: $API_KEY" -H "X-API-Secret: $API_SECRET"

const res = await fetch("https://companybelgium.be/api/v2/enterprise/0403.170.701", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.API_KEY,
    "X-API-Secret": process.env.API_SECRET,
  },
});
const { data } = await res.json();

Antwoord

{
  "success": true,
  "data": {
    "enterpriseNumber": "0403.170.701",
    "status": "AC",
    "juridicalForm": {
      "code": "014",
      "label": "Société anonyme"
    },
    "startDate": "1968-05-30",
    "denomination": "Anheuser-Busch InBev",
    "address": {
      "street": "Grand-Place",
      "number": "1",
      "zipcode": "1000",
      "municipality": "Bruxelles",
      "country": "BE"
    },
    "mainActivity": {
      "naceVersion": "2025",
      "code": "11050",
      "label": "Fabrication de bière"
    }
  },
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}

List all enterprise activities#

GET/enterprise/{num}/activities

Every NACE activity registered for the enterprise, across all classifications and versions.

Parameters

Naam	In/Type	Verplicht	Omschrijving
`num`	path string	Verplicht	Enterprise number.

Verzoek

curl https://companybelgium.be/api/v2/enterprise/0403.170.701/activities \
  -H "X-API-Key: $API_KEY" -H "X-API-Secret: $API_SECRET"

const res = await fetch("https://companybelgium.be/api/v2/enterprise/0403.170.701/activities", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.API_KEY,
    "X-API-Secret": process.env.API_SECRET,
  },
});
const { data } = await res.json();

Antwoord

{
  "success": true,
  "data": [
    {
      "naceVersion": "2025",
      "code": "11050",
      "label": "Fabrication de bière",
      "classification": "MAIN"
    }
  ],
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}

Retrieve the registered office address#

GET/enterprise/{num}/address

The current registered office (siège social) of the enterprise.

Parameters

Naam	In/Type	Verplicht	Omschrijving
`num`	path string	Verplicht	Enterprise number.

Verzoek

curl https://companybelgium.be/api/v2/enterprise/0403.170.701/address \
  -H "X-API-Key: $API_KEY" -H "X-API-Secret: $API_SECRET"

const res = await fetch("https://companybelgium.be/api/v2/enterprise/0403.170.701/address", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.API_KEY,
    "X-API-Secret": process.env.API_SECRET,
  },
});
const { data } = await res.json();

Antwoord

{
  "success": true,
  "data": {
    "street": "Grand-Place",
    "number": "1",
    "zipcode": "1000",
    "municipality": "Bruxelles",
    "country": "BE"
  },
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}

Retrieve contact information#

GET/enterprise/{num}/contact

Phone, email and website published for the enterprise, when available.

Parameters

Naam	In/Type	Verplicht	Omschrijving
`num`	path string	Verplicht	Enterprise number.

Verzoek

curl https://companybelgium.be/api/v2/enterprise/0403.170.701/contact \
  -H "X-API-Key: $API_KEY" -H "X-API-Secret: $API_SECRET"

const res = await fetch("https://companybelgium.be/api/v2/enterprise/0403.170.701/contact", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.API_KEY,
    "X-API-Secret": process.env.API_SECRET,
  },
});
const { data } = await res.json();

Antwoord

{
  "success": true,
  "data": {
    "phone": "+32 2 000 00 00",
    "email": "info@example.be",
    "website": "https://example.be"
  },
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}

List all enterprise denominations#

GET/enterprise/{num}/denominations

Every registered name: legal name, abbreviation and commercial names, in all languages.

Parameters

Naam	In/Type	Verplicht	Omschrijving
`num`	path string	Verplicht	Enterprise number.

Verzoek

curl https://companybelgium.be/api/v2/enterprise/0403.170.701/denominations \
  -H "X-API-Key: $API_KEY" -H "X-API-Secret: $API_SECRET"

const res = await fetch("https://companybelgium.be/api/v2/enterprise/0403.170.701/denominations", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.API_KEY,
    "X-API-Secret": process.env.API_SECRET,
  },
});
const { data } = await res.json();

Antwoord

{
  "success": true,
  "data": [
    {
      "language": "FR",
      "type": "SOCIAL",
      "value": "Anheuser-Busch InBev"
    }
  ],
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}

Retrieve a specific denomination#

GET/enterprise/{num}/denomination/{language}/{type}

A single denomination filtered by language (FR, NL, DE, EN) and type (SOCIAL, ABBREVIATION, COMMERCIAL).

Parameters

Naam	In/Type	Verplicht	Omschrijving
`num`	path string	Verplicht	Enterprise number.
`language`	path string	Verplicht	FR \| NL \| DE \| EN
`type`	path string	Verplicht	SOCIAL \| ABBREVIATION \| COMMERCIAL

Verzoek

curl https://companybelgium.be/api/v2/enterprise/0403.170.701/denomination/FR/SOCIAL \
  -H "X-API-Key: $API_KEY" -H "X-API-Secret: $API_SECRET"

const res = await fetch("https://companybelgium.be/api/v2/enterprise/0403.170.701/denomination/FR/SOCIAL", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.API_KEY,
    "X-API-Secret": process.env.API_SECRET,
  },
});
const { data } = await res.json();

Antwoord

{
  "success": true,
  "data": {
    "language": "FR",
    "type": "SOCIAL",
    "value": "Anheuser-Busch InBev"
  },
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}

List attached establishments#

GET/enterprise/{num}/establishments

All establishment units (unités d’établissement) linked to the enterprise.

Parameters

Naam	In/Type	Verplicht	Omschrijving
`num`	path string	Verplicht	Enterprise number.

Verzoek

curl https://companybelgium.be/api/v2/enterprise/0403.170.701/establishments \
  -H "X-API-Key: $API_KEY" -H "X-API-Secret: $API_SECRET"

const res = await fetch("https://companybelgium.be/api/v2/enterprise/0403.170.701/establishments", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.API_KEY,
    "X-API-Secret": process.env.API_SECRET,
  },
});
const { data } = await res.json();

Antwoord

{
  "success": true,
  "data": [
    {
      "establishmentNumber": "2.123.456.789",
      "startDate": "1990-01-01",
      "municipality": "Leuven"
    }
  ],
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}

Short financial summary#

GET/enterprise/{num}/financial

Latest annual filing plus a 3-year trend, enriched from NBB Central Balance Sheet Office (CBSO) data.

Parameters

Naam	In/Type	Verplicht	Omschrijving
`num`	path string	Verplicht	Enterprise number.

Verzoek

curl https://companybelgium.be/api/v2/enterprise/0403.170.701/financial \
  -H "X-API-Key: $API_KEY" -H "X-API-Secret: $API_SECRET"

const res = await fetch("https://companybelgium.be/api/v2/enterprise/0403.170.701/financial", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.API_KEY,
    "X-API-Secret": process.env.API_SECRET,
  },
});
const { data } = await res.json();

Antwoord

{
  "success": true,
  "data": {
    "latestFiling": "2024-12-31",
    "equity": 12345678,
    "revenue": 98765432,
    "trend": [
      {
        "year": 2022,
        "equity": 9
      },
      {
        "year": 2023,
        "equity": 10
      },
      {
        "year": 2024,
        "equity": 12
      }
    ]
  },
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}

Beneficial owners and officers#

GET/enterprise/{num}/roles

Directors, legal representatives and UBO (beneficial owners) extracted from the Moniteur Belge / Belgisch Staatsblad.

Parameters

Naam	In/Type	Verplicht	Omschrijving
`num`	path string	Verplicht	Enterprise number.

Verzoek

curl https://companybelgium.be/api/v2/enterprise/0403.170.701/roles \
  -H "X-API-Key: $API_KEY" -H "X-API-Secret: $API_SECRET"

const res = await fetch("https://companybelgium.be/api/v2/enterprise/0403.170.701/roles", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.API_KEY,
    "X-API-Secret": process.env.API_SECRET,
  },
});
const { data } = await res.json();

Antwoord

{
  "success": true,
  "data": [
    {
      "role": "DIRECTOR",
      "name": "Jane Doe",
      "since": "2019-03-12"
    }
  ],
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}