Detail d'un etablissement

Recupere les informations completes d'un etablissement belge a partir de son numero d'unite d'etablissement (10 chiffres). La reponse inclut les denominations, adresses, activites NACE et coordonnees de contact.

GET

/api/v2/establishment/{num}

Headers

Header	Value	Description
`X-API-Key`	`pk_live_...`	Votre cle API publique
`X-API-Secret`	`sk_live_...`	Votre cle API secrete

Paramètres

Name	Type	Description
`num` requis	`string`	Numero d'etablissement (10 chiffres, avec ou sans points)Exemple: `2.236.085.668`

Exemple de requête

cURL

curl -X GET \
  "https://companybelgium.be/api/v2/establishment/2.236.085.668" \
  -H "X-API-Key: pk_live_votre_cle" \
  -H "X-API-Secret: sk_live_votre_secret"

JavaScript / Node.js

const response = await fetch(
  "https://companybelgium.be/api/v2/establishment/2.236.085.668",
  {
    headers: {
      "X-API-Key": process.env.API_KEY,
      "X-API-Secret": process.env.API_SECRET,
    },
  }
);

const { success, data } = await response.json();

if (success) {
  console.log("Etablissement :", data.establishmentNumber);
  console.log("Entreprise :", data.enterpriseNumber);
  console.log("Nom :", data.name);
  console.log("Adresse :", data.address);
  console.log("Activites :", data.activities.length);
}

Python

import requests

response = requests.get(
    "https://companybelgium.be/api/v2/establishment/2.236.085.668",
    headers={
        "X-API-Key": "pk_live_votre_cle",
        "X-API-Secret": "sk_live_votre_secret",
    },
)
data = response.json()

if data["success"]:
    est = data["data"]
    print(f"Etablissement : {est['establishmentNumber']}")
    print(f"Entreprise : {est['enterpriseNumber']}")
    print(f"Nom : {est['name']}")
    print(f"Adresse : {est['address']}")
    print(f"Activites : {len(est['activities'])}")

Exemple de réponse

200 OK

{
  "success": true,
  "data": {
    "establishmentNumber": "2.236.085.668",
    "enterpriseNumber": "0835.225.633",
    "enterpriseName": "ESPERO-SOFT INFORMATIQUES",
    "name": "ESPERO-SOFT INFORMATIQUES",
    "address": "Rue de la Technologie 15, 1000 Bruxelles, Belgique",
    "addressDetail": {
      "street": "Rue de la Technologie",
      "houseNumber": "15",
      "box": null,
      "zipcode": "1000",
      "city": "Bruxelles",
      "country": "BE"
    },
    "startDate": "2024-03-01",
    "phone": "+32 2 123 45 67",
    "mobile": "+32 470 12 34 56",
    "email": "info@espero-soft.com",
    "fax": null,
    "website": "https://espero-soft.com",
    "activities": [
      {
        "naceCode": "62.010",
        "description": "Programmation informatique",
        "classification": "NACE-BEL 2008"
      },
      {
        "naceCode": "62.020",
        "description": "Conseil informatique",
        "classification": "NACE-BEL 2008"
      }
    ],
    "denominations": [
      {
        "type": "001",
        "language": "FR",
        "value": "ESPERO-SOFT INFORMATIQUES"
      },
      {
        "type": "001",
        "language": "NL",
        "value": "ESPERO-SOFT INFORMATIQUES"
      }
    ]
  },
  "timestamp": "2026-04-17T10:00:00.000Z"
}

Codes d'erreur

400

Format du numero d'etablissement invalide

400

{
  "success": false,
  "error": "Invalid establishment number format",
  "timestamp": "2026-04-17T10:00:00.000Z"
}

404

Etablissement introuvable dans la base de donnees BCE/KBO

404

{
  "success": false,
  "error": "Establishment 2.236.085.668 not found",
  "timestamp": "2026-04-17T10:00:00.000Z"
}

Mise en cache

Durée du cache: Les donnees sont mises en cache pendant 60 secondes cote serveur.

Notes

Le numero d'etablissement peut etre fourni avec ou sans points (2.236.085.668 ou 2236085668).
Les champs phone, mobile, email, fax et website peuvent etre null si l'etablissement n'a pas renseigne ces informations.
Les activites retournees correspondent aux codes NACE-BEL enregistres pour cet etablissement.

Activites d'un etablissement

Retourne la liste des activites NACE enregistrees pour un etablissement. Chaque activite inclut le code NACE, sa description et la classification utilisee.

GET

/api/v2/establishment/{num}/activities

Headers

Header	Value	Description
`X-API-Key`	`pk_live_...`	Votre cle API publique
`X-API-Secret`	`sk_live_...`	Votre cle API secrete

Paramètres

Name	Type	Description
`num` requis	`string`	Numero d'etablissement (10 chiffres, avec ou sans points)Exemple: `2.236.085.668`

Exemple de requête

cURL

curl -X GET \
  "https://companybelgium.be/api/v2/establishment/2.236.085.668/activities" \
  -H "X-API-Key: pk_live_votre_cle" \
  -H "X-API-Secret: sk_live_votre_secret"

JavaScript / Node.js

const response = await fetch(
  "https://companybelgium.be/api/v2/establishment/2.236.085.668/activities",
  {
    headers: {
      "X-API-Key": process.env.API_KEY,
      "X-API-Secret": process.env.API_SECRET,
    },
  }
);

const { success, data } = await response.json();

if (success) {
  console.log("Total activites :", data.total);
  data.items.forEach((activity) => {
    console.log(`  ${activity.naceCode} - ${activity.description}`);
  });
}

Python

import requests

response = requests.get(
    "https://companybelgium.be/api/v2/establishment/2.236.085.668/activities",
    headers={
        "X-API-Key": "pk_live_votre_cle",
        "X-API-Secret": "sk_live_votre_secret",
    },
)
data = response.json()

if data["success"]:
    print(f"Total activites : {data['data']['total']}")
    for activity in data["data"]["items"]:
        print(f"  {activity['naceCode']} - {activity['description']}")

Exemple de réponse

200 OK

{
  "success": true,
  "data": {
    "items": [
      {
        "naceCode": "62.010",
        "description": "Programmation informatique",
        "classification": "NACE-BEL 2008"
      },
      {
        "naceCode": "62.020",
        "description": "Conseil informatique",
        "classification": "NACE-BEL 2008"
      },
      {
        "naceCode": "63.110",
        "description": "Traitement de donnees, hebergement et activites connexes",
        "classification": "NACE-BEL 2008"
      }
    ],
    "total": 3
  },
  "timestamp": "2026-04-17T10:00:00.000Z"
}

Codes d'erreur

400

Format du numero d'etablissement invalide

400

{
  "success": false,
  "error": "Invalid establishment number format",
  "timestamp": "2026-04-17T10:00:00.000Z"
}

404

Etablissement introuvable dans la base de donnees BCE/KBO

404

{
  "success": false,
  "error": "Establishment 2.236.085.668 not found",
  "timestamp": "2026-04-17T10:00:00.000Z"
}

Notes

La reponse contient un objet avec items (tableau d'activites) et total (nombre total).
Si l'etablissement n'a aucune activite enregistree, items sera un tableau vide et total sera 0.

Adresse d'un etablissement

Retourne l'adresse d'un etablissement sous deux formats : une adresse formatee lisible et un objet detaille avec chaque composant de l'adresse.

GET

/api/v2/establishment/{num}/address

Headers

Header	Value	Description
`X-API-Key`	`pk_live_...`	Votre cle API publique
`X-API-Secret`	`sk_live_...`	Votre cle API secrete

Paramètres

Name	Type	Description
`num` requis	`string`	Numero d'etablissement (10 chiffres, avec ou sans points)Exemple: `2.236.085.668`

Exemple de requête

cURL

curl -X GET \
  "https://companybelgium.be/api/v2/establishment/2.236.085.668/address" \
  -H "X-API-Key: pk_live_votre_cle" \
  -H "X-API-Secret: sk_live_votre_secret"

JavaScript / Node.js

const response = await fetch(
  "https://companybelgium.be/api/v2/establishment/2.236.085.668/address",
  {
    headers: {
      "X-API-Key": process.env.API_KEY,
      "X-API-Secret": process.env.API_SECRET,
    },
  }
);

const { success, data } = await response.json();

if (success) {
  console.log("Adresse formatee :", data.formatted);
  if (data.detail) {
    console.log("Rue :", data.detail.street);
    console.log("Code postal :", data.detail.zipcode);
    console.log("Ville :", data.detail.city);
  }
}

Python

import requests

response = requests.get(
    "https://companybelgium.be/api/v2/establishment/2.236.085.668/address",
    headers={
        "X-API-Key": "pk_live_votre_cle",
        "X-API-Secret": "sk_live_votre_secret",
    },
)
data = response.json()

if data["success"]:
    print(f"Adresse formatee : {data['data']['formatted']}")
    detail = data["data"]["detail"]
    if detail:
        print(f"Rue : {detail['street']}")
        print(f"Code postal : {detail['zipcode']}")
        print(f"Ville : {detail['city']}")

Exemple de réponse

200 OK

{
  "success": true,
  "data": {
    "formatted": "Rue de la Technologie 15, 1000 Bruxelles, Belgique",
    "detail": {
      "street": "Rue de la Technologie",
      "houseNumber": "15",
      "box": null,
      "zipcode": "1000",
      "city": "Bruxelles",
      "country": "BE"
    }
  },
  "timestamp": "2026-04-17T10:00:00.000Z"
}

Codes d'erreur

400

Format du numero d'etablissement invalide

400

{
  "success": false,
  "error": "Invalid establishment number format",
  "timestamp": "2026-04-17T10:00:00.000Z"
}

404

Etablissement introuvable dans la base de donnees BCE/KBO

404

{
  "success": false,
  "error": "Establishment 2.236.085.668 not found",
  "timestamp": "2026-04-17T10:00:00.000Z"
}

Notes

Le champ formatted est une chaine lisible de l'adresse complete. Il peut etre null si aucune adresse n'est enregistree.
Le champ detail contient les composants individuels de l'adresse (rue, numero, boite, code postal, ville, pays).
Le champ box correspond au numero de boite postale et peut etre null.

Coordonnees de contact d'un etablissement

Retourne les coordonnees de contact d'un etablissement : telephone, mobile, email, fax et site web. Chaque champ peut etre null si l'information n'est pas disponible dans la base BCE/KBO.

GET

/api/v2/establishment/{num}/contact

Headers

Header	Value	Description
`X-API-Key`	`pk_live_...`	Votre cle API publique
`X-API-Secret`	`sk_live_...`	Votre cle API secrete

Paramètres

Name	Type	Description
`num` requis	`string`	Numero d'etablissement (10 chiffres, avec ou sans points)Exemple: `2.236.085.668`

Exemple de requête

cURL

curl -X GET \
  "https://companybelgium.be/api/v2/establishment/2.236.085.668/contact" \
  -H "X-API-Key: pk_live_votre_cle" \
  -H "X-API-Secret: sk_live_votre_secret"

JavaScript / Node.js

const response = await fetch(
  "https://companybelgium.be/api/v2/establishment/2.236.085.668/contact",
  {
    headers: {
      "X-API-Key": process.env.API_KEY,
      "X-API-Secret": process.env.API_SECRET,
    },
  }
);

const { success, data } = await response.json();

if (success) {
  console.log("Telephone :", data.phone);
  console.log("Mobile :", data.mobile);
  console.log("Email :", data.email);
  console.log("Fax :", data.fax);
  console.log("Site web :", data.website);
}

Python

import requests

response = requests.get(
    "https://companybelgium.be/api/v2/establishment/2.236.085.668/contact",
    headers={
        "X-API-Key": "pk_live_votre_cle",
        "X-API-Secret": "sk_live_votre_secret",
    },
)
data = response.json()

if data["success"]:
    contact = data["data"]
    print(f"Telephone : {contact['phone']}")
    print(f"Mobile : {contact['mobile']}")
    print(f"Email : {contact['email']}")
    print(f"Fax : {contact['fax']}")
    print(f"Site web : {contact['website']}")

Exemple de réponse

200 OK

{
  "success": true,
  "data": {
    "phone": "+32 2 123 45 67",
    "mobile": "+32 470 12 34 56",
    "email": "info@espero-soft.com",
    "fax": null,
    "website": "https://espero-soft.com"
  },
  "timestamp": "2026-04-17T10:00:00.000Z"
}

Codes d'erreur

400

Format du numero d'etablissement invalide

400

{
  "success": false,
  "error": "Invalid establishment number format",
  "timestamp": "2026-04-17T10:00:00.000Z"
}

404

Etablissement introuvable dans la base de donnees BCE/KBO

404

{
  "success": false,
  "error": "Establishment 2.236.085.668 not found",
  "timestamp": "2026-04-17T10:00:00.000Z"
}

Notes

Tous les champs (phone, mobile, email, fax, website) peuvent etre null si l'etablissement n'a pas renseigne ces informations dans la BCE.
Les numeros de telephone sont retournes au format international (+32 ...).

Denominations d'un etablissement

Retourne toutes les denominations (noms) enregistrees pour un etablissement, dans toutes les langues et tous les types disponibles (denomination sociale, nom commercial, abbreviation...).

GET

/api/v2/establishment/{num}/denominations

Headers

Header	Value	Description
`X-API-Key`	`pk_live_...`	Votre cle API publique
`X-API-Secret`	`sk_live_...`	Votre cle API secrete

Paramètres

Name	Type	Description
`num` requis	`string`	Numero d'etablissement (10 chiffres, avec ou sans points)Exemple: `2.236.085.668`

Exemple de requête

cURL

curl -X GET \
  "https://companybelgium.be/api/v2/establishment/2.236.085.668/denominations" \
  -H "X-API-Key: pk_live_votre_cle" \
  -H "X-API-Secret: sk_live_votre_secret"

JavaScript / Node.js

const response = await fetch(
  "https://companybelgium.be/api/v2/establishment/2.236.085.668/denominations",
  {
    headers: {
      "X-API-Key": process.env.API_KEY,
      "X-API-Secret": process.env.API_SECRET,
    },
  }
);

const { success, data } = await response.json();

if (success) {
  console.log("Denominations :");
  data.forEach((denom) => {
    console.log(`  [${denom.language}] ${denom.value} (type: ${denom.type})`);
  });
}

Python

import requests

response = requests.get(
    "https://companybelgium.be/api/v2/establishment/2.236.085.668/denominations",
    headers={
        "X-API-Key": "pk_live_votre_cle",
        "X-API-Secret": "sk_live_votre_secret",
    },
)
data = response.json()

if data["success"]:
    for denom in data["data"]:
        print(f"  [{denom['language']}] {denom['value']} (type: {denom['type']})")

Exemple de réponse

200 OK

{
  "success": true,
  "data": [
    {
      "type": "001",
      "language": "FR",
      "value": "ESPERO-SOFT INFORMATIQUES"
    },
    {
      "type": "001",
      "language": "NL",
      "value": "ESPERO-SOFT INFORMATIQUES"
    },
    {
      "type": "002",
      "language": "FR",
      "value": "ESPERO-SOFT"
    }
  ],
  "timestamp": "2026-04-17T10:00:00.000Z"
}

Codes d'erreur

400

Format du numero d'etablissement invalide

400

{
  "success": false,
  "error": "Invalid establishment number format",
  "timestamp": "2026-04-17T10:00:00.000Z"
}

404

Etablissement introuvable dans la base de donnees BCE/KBO

404

{
  "success": false,
  "error": "Establishment 2.236.085.668 not found",
  "timestamp": "2026-04-17T10:00:00.000Z"
}

Notes

Le type 001 correspond a la denomination sociale, 002 au nom commercial, 003 a l'abbreviation.
Les langues disponibles sont FR (francais), NL (neerlandais), DE (allemand) et EN (anglais).
Un etablissement peut avoir plusieurs denominations dans la meme langue avec des types differents.

Denomination par langue

Retourne la denomination d'un etablissement pour une langue specifique. Utile pour obtenir directement le nom dans la langue souhaitee sans filtrer la liste complete.

GET

/api/v2/establishment/{num}/denomination/{language}

Headers

Header	Value	Description
`X-API-Key`	`pk_live_...`	Votre cle API publique
`X-API-Secret`	`sk_live_...`	Votre cle API secrete

Paramètres

Name	Type	Description
`num` requis	`string`	Numero d'etablissement (10 chiffres, avec ou sans points)Exemple: `2.236.085.668`
`language` requis	`string`	Code de langue (fr, nl, de ou en)Exemple: `fr`

Exemple de requête

cURL

curl -X GET \
  "https://companybelgium.be/api/v2/establishment/2.236.085.668/denomination/fr" \
  -H "X-API-Key: pk_live_votre_cle" \
  -H "X-API-Secret: sk_live_votre_secret"

JavaScript / Node.js

const establishmentNum = "2.236.085.668";
const language = "fr";

const response = await fetch(
  `https://companybelgium.be/api/v2/establishment/${establishmentNum}/denomination/${language}`,
  {
    headers: {
      "X-API-Key": process.env.API_KEY,
      "X-API-Secret": process.env.API_SECRET,
    },
  }
);

const { success, data } = await response.json();

if (success) {
  console.log("Langue :", data.language);
  console.log("Nom :", data.value);
  console.log("Type :", data.type);
}

Python

import requests

establishment_num = "2.236.085.668"
language = "fr"

response = requests.get(
    f"https://companybelgium.be/api/v2/establishment/{establishment_num}/denomination/{language}",
    headers={
        "X-API-Key": "pk_live_votre_cle",
        "X-API-Secret": "sk_live_votre_secret",
    },
)
data = response.json()

if data["success"]:
    denom = data["data"]
    print(f"Langue : {denom['language']}")
    print(f"Nom : {denom['value']}")
    print(f"Type : {denom['type']}")

Exemple de réponse

200 OK

{
  "success": true,
  "data": {
    "type": "001",
    "language": "FR",
    "value": "ESPERO-SOFT INFORMATIQUES"
  },
  "timestamp": "2026-04-17T10:00:00.000Z"
}

Codes d'erreur

400

Format du numero d'etablissement invalide

400

{
  "success": false,
  "error": "Invalid establishment number format",
  "timestamp": "2026-04-17T10:00:00.000Z"
}

404

Etablissement introuvable dans la base de donnees BCE/KBO

404

{
  "success": false,
  "error": "Establishment 2.236.085.668 not found",
  "timestamp": "2026-04-17T10:00:00.000Z"
}

404

Aucune denomination trouvee pour la langue demandee

404

{
  "success": false,
  "error": "Denomination not found",
  "timestamp": "2026-04-17T10:00:00.000Z"
}

Notes

Les codes de langue acceptes sont : fr, nl, de, en (insensible a la casse).
Si aucune denomination n'existe pour la langue demandee, une erreur 404 est retournee.
Cette route retourne la premiere denomination correspondante a la langue. Pour obtenir toutes les denominations (tous types), utilisez /denominations.

Page précédente

Endpoints Entreprise

Page suivante

Recherche par adresse

Besoin d'aide ?

Notre equipe de support est disponible pour vous aider avec l'integration de l'API.