Quickstart

This guide takes you from nothing to a working request in three steps.

1. Get your API key#

Create an account in the developer portal and generate an API key and an API secret. Keep the secret private — treat it like a password.

2. Make your first request#

Fetch a single enterprise by its BCE number. Send both credential headers on every call.

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"])

3. Read the response#

Every successful response is wrapped in a consistent envelope. The payload you want is under data.

{
  "success": true,
  "data": {
    "enterpriseNumber": "0403.170.701",
    "status": "AC",
    "denomination": "Anheuser-Busch InBev"
  },
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}

ℹ️

That’s it. From here, explore the Enterprise reference for every available field and related sub-resources.