Documentation / Examples

Examples

Copy-paste recipes for the most common tasks. Every call is authenticated — see Authentication.

Fetch an enterprise#

curl https://companybelgium.be/api/v2/enterprise/0403.170.701 \
  -H "X-API-Key: $API_KEY" \
  -H "X-API-Secret: $API_SECRET"
const res = await fetch(
  "https://companybelgium.be/api/v2/enterprise/0403.170.701",
  {
    headers: {
      "X-API-Key": process.env.API_KEY,
      "X-API-Secret": process.env.API_SECRET,
    },
  }
);
const { success, data } = await res.json();
import os, requests

r = requests.get(
    "https://companybelgium.be/api/v2/enterprise/0403.170.701",
    headers={
        "X-API-Key": os.environ["API_KEY"],
        "X-API-Secret": os.environ["API_SECRET"],
    },
)
payload = r.json()
print(payload["data"])

Search by company name#

curl "https://companybelgium.be/api/v2/denominations?q=inbev&limit=5" \
  -H "X-API-Key: $API_KEY" -H "X-API-Secret: $API_SECRET"

Search by address#

curl "https://companybelgium.be/api/v2/search/address?postalCode=1000&street=Grand-Place" \
  -H "X-API-Key: $API_KEY" -H "X-API-Secret: $API_SECRET"

Validate an EU VAT number#

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

Search NACE activity codes#

curl "https://companybelgium.be/api/v2/naces?q=biere&version=2025&limit=10" \
  -H "X-API-Key: $API_KEY" -H "X-API-Secret: $API_SECRET"
ℹ️

Prefer to explore interactively? Open the API Playground and fire real requests from your browser.