Schnellstart

Diese Anleitung führt Sie in drei Schritten von null zu einer funktionierenden Anfrage.

1. API-Schlüssel holen#

Erstellen Sie ein Konto im Entwicklerportal und generieren Sie einen API-Schlüssel und ein Secret. Halten Sie das Secret geheim — behandeln Sie es wie ein Passwort.

2. Erste Anfrage stellen#

Rufen Sie ein Unternehmen über seine BCE-Nummer ab. Senden Sie beide Credential-Header bei jedem Aufruf.

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. Antwort lesen#

Jede erfolgreiche Antwort steckt in einer konsistenten Envelope. Die gewünschte Payload liegt unter 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
}

ℹ️

Das war’s. Erkunden Sie als Nächstes die Unternehmen-Referenz für alle Felder und Subressourcen.