Détails d'une entreprise

Obtenir les informations détaillées d'une entreprise par son numéro BCE. Le numéro peut être au format 0123.456.789, 0123456789 ou BE0123456789. La réponse inclut les activités NACE, les établissements et les mandataires.

GET

/api/companies/{id}

Headers

Header	Value	Description
`X-API-Key`	`pk_live_...`	Clé API (obligatoire)

Paramètres

Name	Type	Description
`id` requis	`string (path)`	Numéro BCE de l'entreprise (10 chiffres). Formats acceptés: 0123.456.789, 0123456789 ou BE0123456789Exemple: `0202.239.951`

Exemple de requête

cURL

# Avec points
curl -X GET "https://companybelgium.be/api/companies/0202.239.951" \
  -H "X-API-Key: pk_live_votre_cle"

# Sans points
curl -X GET "https://companybelgium.be/api/companies/0202239951" \
  -H "X-API-Key: pk_live_votre_cle"

# Avec préfixe BE
curl -X GET "https://companybelgium.be/api/companies/BE0202239951" \
  -H "X-API-Key: pk_live_votre_cle"

JavaScript / Node.js

const enterpriseNumber = '0202.239.951';

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

const data = await response.json();

if (data.success) {
  const company = data.data;
  console.log(`Nom: ${company.name}`);
  console.log(`Forme juridique: ${company.juridicalForm}`);
  console.log(`Adresse: ${company.address}`);
  console.log(`Activités: ${company.activities?.length || 0}`);
  console.log(`Établissements: ${company.establishments?.length || 0}`);
}

Python

import requests

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

if data['success']:
    company = data['data']
    print(f"Nom: {company['name']}")
    print(f"Forme juridique: {company.get('juridicalForm', 'N/A')}")
    print(f"Activités NACE:")
    for activity in company.get('activities', []):
        print(f"  - {activity['naceCode']}: {activity['description']}")

Exemple de réponse

200 OK

{
  "success": true,
  "data": {
    "enterpriseNumber": "0202.239.951",
    "name": "Proximus SA de droit public",
    "status": "Active",
    "type": "Personne morale",
    "juridicalForm": "SA de droit public",
    "startDate": "01/01/1994",
    "address": "Boulevard du Roi Albert II 27, 1030 Bruxelles",
    "phone": "+32 2 202 41 11",
    "email": "info@proximus.com",
    "website": "https://www.proximus.be",
    "activities": [
      {
        "naceCode": "61.100",
        "description": "Télécommunications par câble",
        "classification": "Activité principale"
      },
      {
        "naceCode": "61.200",
        "description": "Télécommunications sans fil",
        "classification": "Activité secondaire"
      }
    ],
    "establishments": [
      {
        "establishmentNumber": "2.123.456.789",
        "name": "Siège d'exploitation",
        "address": "Boulevard du Roi Albert II 27, 1030 Bruxelles",
        "startDate": "01/01/1994"
      }
    ],
    "functions": [
      {
        "functionType": "Administrateur",
        "person": "Guillaume Boutin",
        "startDate": "01/04/2019"
      }
    ]
  },
  "timestamp": "2026-02-08T12:00:00.000Z",
  "meta": {
    "responseTime": 520
  }
}

Codes d'erreur

400 Bad Request

Format du numéro BCE invalide

400 Bad Request

{
  "success": false,
  "error": "Invalid enterprise number format",
  "timestamp": "2026-02-08T12:00:00.000Z"
}

404 Not Found

Entreprise non trouvée

404 Not Found

{
  "success": false,
  "error": "Company not found",
  "timestamp": "2026-02-08T12:00:00.000Z"
}

Mise en cache

Durée du cache: 1 heure (stale-while-revalidate: 2 heures)

Notes

Le numéro BCE est automatiquement normalisé (suppression des points, du préfixe BE).
La réponse inclut les activités NACE, les établissements et les fonctions/mandataires.
Certains champs (phone, email, website) peuvent être absents si non renseignés dans la BCE.

Page précédente

Recherche par adresse

Page suivante

Recherche d'établissements

Besoin d'aide ?

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