Documentatie / Zoeken

Zoeken

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

🔗

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

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

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

Verzoek

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();

Antwoord

{
  "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
}