CompanyBelgium

Get Establishment Details

Retrieve detailed information about a specific Belgian establishment using its establishment number (numéro d'unité d'établissement). Returns complete data including addresses, activities, and parent enterprise information.

GET
/api/establishments/:id

Headers

HeaderValueDescription
X-API-Keypk_live_...Your API public key
X-API-Secretsk_live_...Your API secret key (optional for public access)

Paramètres

NameTypeDescription
id
requis
stringEstablishment number (10 digits, with or without dots)Exemple: 2.123.456.789

Exemple de requête

cURL
curl -X GET \
  "https://companybelgium.be/api/establishments/2.123.456.789" \
  -H "X-API-Key: pk_live_votre_cle"
JavaScript / Node.js
const establishmentNumber = "2.123.456.789";

const response = await fetch(
  `https://companybelgium.be/api/establishments/${establishmentNumber}`,
  {
    headers: {
      'X-API-Key': process.env.API_KEY,
    },
  }
);

const data = await response.json();

if (data.success) {
  const est = data.data;
  console.log(`Name: ${est.name}`);
  console.log(`Enterprise: ${est.enterpriseNumber}`);
  console.log(`Address: ${est.address.street}, ${est.address.zipCode} ${est.address.city}`);
  console.log(`Activities: ${est.activities.length}`);
}
Python
import requests

establishment_number = "2.123.456.789"

response = requests.get(
    f'https://companybelgium.be/api/establishments/{establishment_number}',
    headers={'X-API-Key': 'pk_live_votre_cle'}
)
data = response.json()

if data['success']:
    est = data['data']
    print(f"Name: {est['name']}")
    print(f"Enterprise: {est['enterpriseNumber']}")
    print(f"Address: {est['address']['street']}, {est['address']['zipCode']} {est['address']['city']}")
    print(f"Activities: {len(est['activities'])}")

Exemple de réponse

200 OK
{
  "success": true,
  "data": {
    "establishmentNumber": "2.123.456.789",
    "enterpriseNumber": "0402.206.045",
    "name": "Delhaize Bruxelles Centre",
    "startDate": "15/03/2005",
    "address": {
      "type": "BAET",
      "street": "Rue Neuve 123",
      "houseNumber": "123",
      "zipCode": "1000",
      "city": "Bruxelles",
      "country": "BE"
    },
    "contacts": [
      {
        "type": "TEL",
        "value": "+32 2 123 45 67"
      },
      {
        "type": "EMAIL",
        "value": "bruxelles.centre@delhaize.be"
      }
    ],
    "activities": [
      {
        "naceCode": "47.11",
        "classification": "BE 2008",
        "description": "Commerce de détail en magasin non spécialisé à prédominance alimentaire"
      }
    ],
    "enterprise": {
      "enterpriseNumber": "0402.206.045",
      "name": "Delhaize Group",
      "status": "Active",
      "juridicalForm": "Société Anonyme"
    }
  },
  "timestamp": "2026-04-03T10:30:00.000Z"
}

Besoin d'aide ?

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