Documentation / Démarrage rapide

Démarrage rapide

Ce guide vous mène de rien à une requête fonctionnelle en trois étapes.

1. Obtenez votre clé API#

Créez un compte dans le portail développeur et générez une clé API et un secret. Gardez le secret privé — traitez-le comme un mot de passe.

2. Faites votre première requête#

Récupérez une entreprise par son numéro BCE. Envoyez les deux en-têtes d’identification à chaque appel.

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. Lisez la réponse#

Chaque réponse réussie est encapsulée dans une enveloppe cohérente. Les données utiles se trouvent sous 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
}
ℹ️

C’est tout. Explorez ensuite la référence Entreprise pour tous les champs et sous-ressources.