CompanyBelgium

API BCE : accedez aux donnees de la Banque-Carrefour des Entreprises en Belgique

Decouvrez comment utiliser l'API BCE pour interroger la base de donnees officielle de la Banque-Carrefour des Entreprises (KBO). Recherchez parmi plus de 2 millions d'entreprises belges par nom, numero BCE, adresse ou code NACE. Guide complet avec exemples de code, authentification et bonnes pratiques.

4 avril 202612 min de lecture

En bref

L'API BCE de Company Belgium permet d'interroger en temps réel la base de données officielle de la Banque-Carrefour des Entreprises (KBO) via une interface REST/JSON simple. Elle couvre plus de 2 millions d'entreprises belges avec recherche par nom, numéro BCE, adresse ou code NACE, et retourne des données structurées en moins d'une seconde.

Qu'est-ce que l'API BCE ?

L'API BCE (Banque-Carrefour des Entreprises) est une interface de programmation qui permet d'acceder aux donnees publiques de la KBO (Kruispuntbank van Ondernemingen), la base de donnees centrale de toutes les entreprises enregistrees en Belgique. Avec plus de 2 millions d'entites repertoriees, la BCE constitue la source de reference pour toute information officielle sur les entreprises belges.

Notre API REST vous permet d'interroger ces donnees de maniere rapide, fiable et structuree, sans avoir a scraper le site officiel du SPF Economie ou a telecharger les fichiers Open Data volumineux.

Pourquoi utiliser une API BCE plutot que le site officiel ?

Le site Public Search du SPF Economie permet de consulter les donnees manuellement, mais presente plusieurs limites pour un usage professionnel :

CritereSite officiel BCEAPI BCE Company Belgium
Acces programmatiqueNonOui (REST JSON)
Recherche par nomOui (limité)Oui (pagination complete)
Recherche par adresseNonOui
Recherche par code NACENonOui
Verification PeppolNonOui
Export PDFNonOui
Temps de reponse3-5 secondes< 1 seconde
Rate limitingCaptchaRate limit configurable
Format de donneesHTMLJSON structure

Les donnees disponibles via l'API BCE

Informations generales de l'entreprise

Chaque entreprise dans la BCE dispose d'un numero d'entreprise unique a 10 chiffres (ex: 0123.456.789). Via notre API, vous pouvez recuperer :

  • Denomination : nom officiel, abbreviations, noms commerciaux
  • Forme juridique : SA, SRL, SC, entreprise individuelle...
  • Statut : actif, en cessation, en faillite
  • Date de creation : date de debut d'activite
  • Adresse du siege social : adresse complete avec code postal
  • Codes NACE : activites economiques classifiees
  • Numeros de telephone et email (quand publiquement disponibles)
  • Site web de l'entreprise

Unites d'etablissement

Chaque entreprise peut avoir une ou plusieurs unites d'etablissement (succursales, bureaux, points de vente). L'API retourne pour chaque etablissement :

  • Numero d'unite d'etablissement
  • Adresse complete
  • Date de debut d'activite
  • Codes NACE specifiques

Fonctions et mandataires

Les fonctions officielles enregistrees a la BCE :

  • Administrateurs, gerants, dirigeants
  • Commissaires aux comptes
  • Fondateurs
  • Dates de debut et de fin de mandat

Comment utiliser l'API BCE : guide pas a pas

Etape 1 : Creer un compte gratuit

Rendez-vous sur companybelgium.be et creez votre compte. En quelques secondes, vous accedez a votre tableau de bord.

Etape 2 : Generer vos cles API

Dans la section "Cles API" de votre dashboard, generez une paire de cles :

  • Cle publique (pk_live_...) : identifie votre application
  • Cle secrete (sk_live_...) : authentifie vos requetes

> Important : la cle secrete n'est affichee qu'une seule fois lors de la creation. Conservez-la en lieu sur.

Etape 3 : Effectuer votre premiere recherche

Terminal
1
2
3
4
# Rechercher une entreprise par nom
curl -X GET "https://companybelgium.be/api/companies/search?name=Proximus" \
  -H "X-API-Key: pk_live_votre_cle_publique" \
  -H "X-API-Secret: sk_live_votre_cle_secrete"

Reponse JSON :

JSON
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
  "success": true,
  "data": {
    "results": [
      {
        "enterpriseNumber": "0202.239.951",
        "name": "Proximus",
        "status": "Actif",
        "type": "Personne morale",
        "address": "Boulevard du Roi Albert II 27, 1030 Bruxelles"
      }
    ],
    "totalResults": 15,
    "currentPage": 1,
    "totalPages": 1
  },
  "timestamp": "2026-04-04T10:00:00.000Z",
  "meta": {
    "responseTime": 450
  }
}

Tous les endpoints de l'API BCE

1. Recherche d'entreprises par nom

Code
1
GET /api/companies/search?name={nom}&zipCode={codePostal}&city={ville}&naceCode={nace}&page={page}

Recherchez des entreprises belges par nom, code postal, ville ou code NACE. Au moins un critere de recherche est requis. Les resultats sont pagines.

2. Details d'une entreprise par numero BCE

Code
1
GET /api/companies/{numeroBCE}

Recuperez toutes les informations detaillees d'une entreprise : denomination, forme juridique, adresse, activites NACE, etablissements et mandataires.

3. Recherche par adresse

Code
1
GET /api/companies/address?postalCode={codePostal}&street={rue}&houseNumber={numero}

Trouvez toutes les entreprises enregistrees a une adresse donnee. Ideal pour le due diligence et la recherche d'entreprises par adresse.

4. Etablissements d'une entreprise

Code
1
GET /api/companies/{numeroBCE}/establishments

Listez toutes les unites d'etablissement (succursales) d'une entreprise specifique.

5. Recherche d'etablissements

Code
1
GET /api/establishments/search?name={nom}&zipCode={codePostal}&city={ville}

Recherchez directement dans les unites d'etablissement par nom, code postal ou ville.

6. Verification Peppol

Code
1
GET /api/peppol/check?vatNumber={numeroTVA}

Verifiez si une entreprise est enregistree sur le reseau Peppol pour la facturation electronique. Retourne les identifiants, les types de documents supportes et l'URL du endpoint.

7. Export PDF

Code
1
GET /api/companies/{numeroBCE}/pdf?lang=fr

Generez automatiquement une fiche entreprise au format PDF, prete a etre imprimee ou archivee.

Exemples d'integration

JavaScript / TypeScript

TypeScript
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
class="code-comment">// Recherche dclass="code-string">'entreprise avec l'API BCE
async function searchCompany(name: string) {
  const response = await fetch(
    class="code-string">`https:class="code-comment">//companybelgium.be/api/companies/search?name=${encodeURIComponent(name)}`,
    {
      headers: {
        class="code-string">'X-API-Key': process.env.BCE_API_KEY!,
        class="code-string">'X-API-Secret': process.env.BCE_API_SECRET!,
      },
    }
  );

  if (!response.ok) {
    throw new Error(class="code-string">`API BCE error: ${response.status}`);
  }

  return response.json();
}

class="code-comment">// Utilisation
const result = await searchCompany(class="code-string">'Delhaize');
console.log(class="code-string">`${result.data.totalResults} entreprises trouvees`);

Python

Python
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
import requests

def search_bce(name: str) -> dict:
    """Recherche dans la base de donnees BCE via lclass="code-string">'API"""
    response = requests.get(
        "https://companybelgium.be/api/companies/search",
        params={"name": name},
        headers={
            "X-API-Key": "pk_live_votre_cle",
            "X-API-Secret": "sk_live_votre_secret",
        },
    )
    response.raise_for_status()
    return response.json()

class="code-comment"># Recherche
data = search_bce("Colruyt")
print(class="code-string">f"{data['dataclass="code-string">']['totalResults']} entreprises trouvees")

PHP

php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
<?php
function searchBCE(string $name): array {
    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => "https://companybelgium.be/api/companies/search?name=" . urlencode($name),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            "X-API-Key: pk_live_votre_cle",
            "X-API-Secret: sk_live_votre_secret",
        ],
    ]);
    $response = curl_exec($ch);
    curl_close($ch);
    return json_decode($response, true);
}

$result = searchBCE("Solvay");
echo $result['data']['totalResults'] . " entreprises trouvees";
?>

Cas d'utilisation de l'API BCE

Verification de fournisseurs et partenaires (KYC/AML)

L'API BCE est essentielle pour les procedures Know Your Customer et Anti-Money Laundering — voir notre guide de verification KYC automatisee. Verifiez automatiquement :

  • L'existence et le statut actif d'une entreprise
  • L'adresse du siege social
  • Les mandataires et representants legaux
  • L'enregistrement Peppol pour la facturation electronique

Integration ERP et CRM

Enrichissez automatiquement vos fiches clients et fournisseurs dans votre ERP (SAP, Odoo, Exact Online) ou CRM (Salesforce, HubSpot) avec les donnees officielles BCE — consultez notre guide sur l'integration API BCE dans un ERP ou CRM :

  • Auto-completion a la saisie d'un numero d'entreprise
  • Mise a jour periodique des coordonnees
  • Verification de la forme juridique et du statut

Applications SaaS et Fintech

Les startups et entreprises technologiques utilisent l'API BCE pour :

  • Onboarding automatise : verification d'identite d'entreprise a l'inscription
  • Scoring de credit : croisement des donnees BCE avec d'autres sources
  • Compliance : verification continue des partenaires commerciaux
  • Facturation : auto-remplissage des donnees de facturation via le numero de TVA

Analyse de marche et business intelligence

Exploitez les donnees BCE pour :

  • Analyser la densite d'entreprises par zone geographique

Tarification et plans

PlanRequetes/moisPrix
Gratuit1000 EUR
Starter5 00019 EUR
Pro50 00049 EUR
EnterpriseIllimiteSur devis

Tous les plans incluent :

  • Acces a tous les endpoints (recherche, details, Peppol, PDF)
  • Tableau de bord avec statistiques d'utilisation
  • Support technique par email

Securite et conformite

Authentification double cle

Notre API utilise un systeme a double cle (publique + secrete) pour une securite maximale :

  • La cle secrete est hashee en SHA-256 en base de donnees
  • La comparaison utilise un algorithme timing-safe pour prevenir les attaques par timing
  • Les cles peuvent etre desactivees ou configurees avec une date d'expiration

Conformite RGPD

Les donnees exposees par l'API sont exclusivement des donnees publiques issues de la Banque-Carrefour des Entreprises. Aucune donnee personnelle privee n'est traitee. Notre service est conforme au RGPD et a la legislation belge sur les donnees ouvertes.

Logging et tracabilite

Chaque requete API est tracee avec :

  • Endpoint appele
  • Methode HTTP
  • Code de reponse
  • Temps de reponse

Vous pouvez consulter l'historique complet de vos appels API depuis votre tableau de bord.

FAQ sur l'API BCE

Qu'est-ce que la BCE / KBO ?

La Banque-Carrefour des Entreprises (BCE), en neerlandais Kruispuntbank van Ondernemingen (KBO), est le registre central belge qui repertorie toutes les entites enregistrees en Belgique. Geree par le SPF Economie, elle contient les informations publiques de plus de 2 millions d'entreprises, associations et independants.

L'API BCE est-elle gratuite ?

Oui, nous proposons un plan gratuit avec 100 requetes par mois. C'est suffisant pour tester l'API et developper votre integration. Pour un usage en production, nos plans payants offrent un volume adapte a vos besoins.

Quelle est la difference entre l'API BCE et le fichier Open Data ?

Le fichier Open Data de la BCE est un dump complet de la base de donnees, telecharge sous forme de fichiers CSV compresses (~700 Mo). L'API BCE offre un acces en temps reel, structure en JSON, avec des fonctionnalites de recherche avancee (par nom, adresse, NACE) impossibles avec le fichier brut.

Les donnees sont-elles a jour ?

Nos donnees sont synchronisees quotidiennement avec les sources officielles de la Banque-Carrefour des Entreprises. Le temps de reponse moyen de notre API est inferieur a 1 seconde.

Puis-je utiliser l'API BCE pour de la facturation electronique ?

Oui, notre endpoint Peppol vous permet de verifier si une entreprise est enregistree sur le reseau Peppol pour la facturation electronique. Cela est particulierement utile dans le cadre de l'obligation de facturation electronique B2B en Belgique.

Conclusion

L'API BCE de Company Belgium est la solution la plus simple et la plus rapide pour acceder aux donnees officielles de la Banque-Carrefour des Entreprises. Que vous developpliez une application SaaS, un ERP, un outil de compliance ou une solution de facturation, notre API REST vous fournit des donnees structurees, fiables et a jour.

Creez votre compte gratuit et commencez a interroger la BCE en quelques minutes.

Questions fréquentes

Qu'est-ce que l'API BCE et a quoi sert-elle ?

L'API BCE (Banque-Carrefour des Entreprises) est une interface REST/JSON qui permet d'interroger en temps reel la base de donnees officielle de toutes les entreprises enregistrees en Belgique. Elle sert a verifier l'existence d'une entreprise, recuperer son adresse, ses codes NACE, ses mandataires ou son statut Peppol pour la facturation electronique.

Comment obtenir une cle API pour interroger la BCE ?

Creez un compte gratuit sur companybelgium.be, puis rendez-vous dans la section Cles API de votre tableau de bord. Vous y generez une cle publique (pk_live_...) et une cle secrete (sk_live_...) a transmettre dans les headers X-API-Key et X-API-Secret de chaque requete. Le plan gratuit offre 100 requetes par mois sans carte bancaire.

Les donnees de l'API BCE sont-elles mises a jour quotidiennement ?

Oui, les donnees sont synchronisees chaque jour avec les fichiers Open Data officiels de la Banque-Carrefour des Entreprises (fichiers full et delta du SPF Economie). Le temps de reponse moyen de l'API est inferieur a une seconde, contre 3 a 5 secondes pour le site Public Search officiel.

L'API BCE peut-elle etre utilisee pour le KYC et la conformite AML ?

Oui, l'API BCE est particulierement adaptee aux procedures KYC et AML. Elle permet de verifier le statut actif d'une entreprise, son adresse de siege social, ses mandataires enregistres et son enregistrement Peppol. Pour les obligations legales en Belgique, les professions assujetties doivent respecter la loi du 18 septembre 2017 sur la lutte anti-blanchiment.

Prêt à commencer ?

Créez votre compte gratuitement et obtenez vos clés API en quelques minutes.

Commentaires

Chargement des commentaires…

Laisser un commentaire

Non publié — sert uniquement à vous notifier.

Les commentaires sont modérés avant publication.

Articles similaires