Establishment

Endpoints for the Establishment resource. All calls require authentication and return the standard JSON envelope.

🔗

Base URL: https://companybelgium.be/api/v2 · Authentication

Retrieve establishment details#

GET/establishment/{num}

Full record for a single establishment unit attached to an enterprise.

Parameters

Name	In/Type	Required	Description
`num`	path string	Required	Establishment number, e.g. 2.123.456.789

Request

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

const res = await fetch("https://companybelgium.be/api/v2/establishment/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": {
    "establishmentNumber": "2.123.456.789",
    "enterpriseNumber": "0403.170.701",
    "startDate": "1990-01-01",
    "municipality": "Leuven"
  },
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}

List establishment activities#

GET/establishment/{num}/activities

NACE activities registered at the establishment level.

Parameters

Name	In/Type	Required	Description
`num`	path string	Required	Establishment number.

Request

curl https://companybelgium.be/api/v2/establishment/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/establishment/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": "47250",
      "label": "Commerce de détail de boissons"
    }
  ],
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}

Retrieve establishment address#

GET/establishment/{num}/address

Physical address of the establishment unit.

Parameters

Name	In/Type	Required	Description
`num`	path string	Required	Establishment number.

Request

curl https://companybelgium.be/api/v2/establishment/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/establishment/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": "Brouwersstraat",
    "number": "1",
    "zipcode": "3000",
    "municipality": "Leuven",
    "country": "BE"
  },
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}

Retrieve establishment contact info#

GET/establishment/{num}/contact

Phone, email and website at the establishment level, when available.

Parameters

Name	In/Type	Required	Description
`num`	path string	Required	Establishment number.

Request

curl https://companybelgium.be/api/v2/establishment/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/establishment/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 16 00 00 00",
    "email": null,
    "website": null
  },
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}

List establishment denominations#

GET/establishment/{num}/denominations

Commercial names registered at the establishment level.

Parameters

Name	In/Type	Required	Description
`num`	path string	Required	Establishment number.

Request

curl https://companybelgium.be/api/v2/establishment/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/establishment/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": "NL",
      "type": "COMMERCIAL",
      "value": "Stella Shop"
    }
  ],
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}

Retrieve a specific establishment denomination#

GET/establishment/{num}/denomination/{language}

A single establishment denomination filtered by language.

Parameters

Name	In/Type	Required	Description
`num`	path string	Required	Establishment number.
`language`	path string	Required	FR \| NL \| DE \| EN

Request

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

const res = await fetch("https://companybelgium.be/api/v2/establishment/0403.170.701/denomination/FR", {
  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": "NL",
    "type": "COMMERCIAL",
    "value": "Stella Shop"
  },
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}