Recherche

Endpoints de la ressource Recherche. Tous les appels exigent une authentification et renvoient l’enveloppe JSON standard.

🔗

URL de base: https://companybelgium.be/api/v2 · Authentification

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.

Paramètres

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

Requête

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

Réponse

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