Recherche d'entreprises

Recherche des entreprises dans la BCE/KBO par nom, localisation ou code NACE. Au moins un paramètre de recherche est requis. Les résultats sont paginés avec 20 résultats par page.

GET

/api/companies/search

Headers

Header	Value	Description
`X-API-Key`	`pk_live_...`	Clé API (obligatoire)
`X-API-Secret`	`sk_live_...`	Clé secrète (optionnel)

Paramètres

Name	Type	Description
`name` optionnel	`string`	Nom ou partie du nom de l'entrepriseExemple: `Proximus`
`zipCode` optionnel	`string`	Code postal belge (4 chiffres)Exemple: `1000`
`city` optionnel	`string`	Nom de la villeExemple: `Bruxelles`
`naceCode` optionnel	`string`	Code NACE-BEL 2008 de l'activitéExemple: `62.010`
`page` optionnel	`integer`	Numéro de page pour la paginationExemple: `1`Défaut: `1`

Exemple de requête

cURL

curl -X GET \
  "https://companybelgium.be/api/companies/search?name=Proximus&zipCode=1000" \
  -H "X-API-Key: pk_live_votre_cle"

JavaScript / Node.js

const response = await fetch(
  'https://companybelgium.be/api/companies/search?name=Proximus&zipCode=1000',
  {
    headers: {
      'X-API-Key': process.env.API_KEY,
    },
  }
);

const data = await response.json();

if (data.success) {
  console.log(`${data.meta.totalResults} résultats trouvés`);
  data.data.results.forEach(company => {
    console.log(`${company.name} - ${company.enterpriseNumber}`);
  });
}

Python

import requests

response = requests.get(
    'https://companybelgium.be/api/companies/search',
    params={'name': 'Proximus', 'zipCode': '1000'},
    headers={'X-API-Key': 'pk_live_votre_cle'}
)
data = response.json()

if data['success']:
    print(f"{data['meta']['totalResults']} résultats trouvés")
    for company in data['data']['results']:
        print(f"{company['name']} - {company['enterpriseNumber']}")

Exemple de réponse

200 OK

{
  "success": true,
  "data": {
    "results": [
      {
        "enterpriseNumber": "0202.239.951",
        "name": "Proximus",
        "status": "Active",
        "type": "Personne morale",
        "address": "Boulevard du Roi Albert II 27, 1030 Bruxelles",
        "startDate": "01/01/1994"
      }
    ],
    "totalResults": 5,
    "currentPage": 1,
    "totalPages": 1,
    "searchParams": {
      "name": "Proximus",
      "zipCode": "1000",
      "page": 1
    }
  },
  "timestamp": "2026-02-08T12:00:00.000Z",
  "meta": {
    "totalResults": 5,
    "currentPage": 1,
    "totalPages": 1,
    "responseTime": 342
  }
}

Codes d'erreur

400 Bad Request

Aucun paramètre de recherche fourni

400 Bad Request

{
  "success": false,
  "error": "At least one search parameter is required (name, zipCode, city, or naceCode)",
  "timestamp": "2026-02-08T12:00:00.000Z"
}

Mise en cache

Durée du cache: 10 minutes (stale-while-revalidate: 20 minutes)

Notes

Au moins un paramètre de recherche (name, zipCode, city ou naceCode) est requis.
Les paramètres peuvent être combinés pour affiner la recherche.
Les données proviennent de notre base de données interne, synchronisée régulièrement avec les sources officielles de la BCE/KBO.

Page précédente

Limitation de débit

Page suivante

Recherche par adresse

Besoin d'aide ?

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