Suche

Endpunkte für die Ressource Suche. Alle Aufrufe erfordern Authentifizierung und liefern die Standard-JSON-Envelope.

🔗

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

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.

Parameter

Name	In/Typ	Erforderlich	Beschreibung
`postalCode`	query string	Erforderlich	4-digit Belgian postal code, e.g. 1000.
`street`	query string	Erforderlich	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.

Anfrage

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

Antwort

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