Reference data

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

🔗

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

Search NACE codes#

GET/naces

Full-text search across NACE activity codes and labels, for any classification version.

Parameters

Name	In/Type	Required	Description
`q`	query string	optional	Substring to match in code or description.
`version`	query string	optional	NACE revision, e.g. 2025 or 2008.
`limit`	query integer	optional	Max rows to return (default 20).

Request

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

const res = await fetch("https://companybelgium.be/api/v2/naces", {
  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": [
    {
      "version": "2025",
      "code": "11050",
      "label": "Fabrication de bière"
    }
  ],
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}

Retrieve a NACE entry#

GET/nace/{version}/{code}

A single NACE entry by classification version and code.

Parameters

Name	In/Type	Required	Description
`version`	path string	Required	NACE revision, e.g. 2025.
`code`	path string	Required	NACE code, e.g. 11050.

Request

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

const res = await fetch("https://companybelgium.be/api/v2/nace/2025/11050", {
  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": {
    "version": "2025",
    "code": "11050",
    "label": "Fabrication de bière"
  },
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}

List / search juridical forms#

GET/juridical-forms

Belgian legal forms (SA/NV, SRL/BV, ASBL/VZW…) with their official codes and multilingual labels.

Parameters

Name	In/Type	Required	Description
`q`	query string	optional	Optional search term.

Request

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

const res = await fetch("https://companybelgium.be/api/v2/juridical-forms", {
  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": [
    {
      "code": "014",
      "label": "Société anonyme"
    },
    {
      "code": "610",
      "label": "Société à responsabilité limitée"
    }
  ],
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}

List / search juridical situations#

GET/juridical-situations

Status codes describing the legal situation of an enterprise (active, bankrupt, dissolved…).

Parameters

Name	In/Type	Required	Description
`q`	query string	optional	Optional search term.

Request

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

const res = await fetch("https://companybelgium.be/api/v2/juridical-situations", {
  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": [
    {
      "code": "000",
      "label": "Situation normale"
    }
  ],
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}

Autocomplete enterprise names#

GET/denominations

Type-ahead search over enterprise denominations. Ideal for a "search by company name" input.

Parameters

Name	In/Type	Required	Description
`q`	query string	Required	Search term (min. 2 characters).
`limit`	query integer	optional	Max suggestions (default 10).

Request

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

const res = await fetch("https://companybelgium.be/api/v2/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": [
    {
      "enterpriseNumber": "0403.170.701",
      "denomination": "Anheuser-Busch InBev"
    }
  ],
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}