Enterprise
Endpoints for the Enterprise resource. All calls require authentication and return the standard JSON envelope.
Base URL: https://companybelgium.be/api/v2 · Authentication
Retrieve enterprise details#
Full record for a single enterprise: status, juridical form, start date, denominations, registered office and primary activity.
Parameters
| Name | In/Type | Required | Description |
|---|---|---|---|
num |
path string | Required | Enterprise number (BCE/KBO), e.g. 0403.170.701. Dots optional. |
Request
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();Response
{
"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#
Every NACE activity registered for the enterprise, across all classifications and versions.
Parameters
| Name | In/Type | Required | Description |
|---|---|---|---|
num |
path string | Required | Enterprise number. |
Request
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();Response
{
"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#
The current registered office (siège social) of the enterprise.
Parameters
| Name | In/Type | Required | Description |
|---|---|---|---|
num |
path string | Required | Enterprise number. |
Request
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();Response
{
"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#
Phone, email and website published for the enterprise, when available.
Parameters
| Name | In/Type | Required | Description |
|---|---|---|---|
num |
path string | Required | Enterprise number. |
Request
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();Response
{
"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#
Every registered name: legal name, abbreviation and commercial names, in all languages.
Parameters
| Name | In/Type | Required | Description |
|---|---|---|---|
num |
path string | Required | Enterprise number. |
Request
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();Response
{
"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#
A single denomination filtered by language (FR, NL, DE, EN) and type (SOCIAL, ABBREVIATION, COMMERCIAL).
Parameters
| Name | In/Type | Required | Description |
|---|---|---|---|
num |
path string | Required | Enterprise number. |
language |
path string | Required | FR | NL | DE | EN |
type |
path string | Required | SOCIAL | ABBREVIATION | COMMERCIAL |
Request
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();Response
{
"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#
All establishment units (unités d’établissement) linked to the enterprise.
Parameters
| Name | In/Type | Required | Description |
|---|---|---|---|
num |
path string | Required | Enterprise number. |
Request
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();Response
{
"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#
Latest annual filing plus a 3-year trend, enriched from NBB Central Balance Sheet Office (CBSO) data.
Parameters
| Name | In/Type | Required | Description |
|---|---|---|---|
num |
path string | Required | Enterprise number. |
Request
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();Response
{
"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#
Directors, legal representatives and UBO (beneficial owners) extracted from the Moniteur Belge / Belgisch Staatsblad.
Parameters
| Name | In/Type | Required | Description |
|---|---|---|---|
num |
path string | Required | Enterprise number. |
Request
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();Response
{
"success": true,
"data": [
{
"role": "DIRECTOR",
"name": "Jane Doe",
"since": "2019-03-12"
}
],
"error": null,
"timestamp": "2026-06-05T09:00:00.000Z",
"meta": null
}