Search

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

🔗

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

Search enterprises by postal address#

GET/search/address

Find enterprises registered at a given Belgian address. Street is matched partially (FR or NL); results are paginated.

Parameters

Name	In/Type	Required	Description
`postalCode`	query string	Required	4-digit Belgian postal code, e.g. 1000.
`street`	query string	Required	Street name (partial match, FR or NL).
`houseNumber`	query string	optional	Exact house number.
`page`	query integer	optional	1-based page number (20 results per page).
`pageSize`	query integer	optional	Results per page (default 20, max 100). Alias: limit.

Request

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

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