1. Créer un espace et une clé
Suivez le parcours client, choisissez votre abonnement, vérifiez votre e-mail et créez une clé. Conservez le secret affiché à sa création.
2. Envoyer une requête serveur
Définissez COMPANYAPI_KEY sur le serveur. Recherchez par nom avec X-Api-Key. Cet exemple renvoie un tableau de candidats.
curl --get 'https://api.companyapi.be/companies' \
--data-urlencode 'name=Colruyt' \
--data-urlencode 'limit=5' \
--header "X-Api-Key: $COMPANYAPI_KEY"3. Récupérer les détails
Sélectionnez le numéro voulu et demandez les détails étendus : adresses, contacts et activités disponibles. La recherche de base fournit identité et statut juridique.
curl 'https://api.companyapi.be/companies/0801523965/extended' \
--header "X-Api-Key: $COMPANYAPI_KEY"4. Gérer les réponses
Distinguez 400 saisie invalide, 401 authentification, 404 absence et 429 limitation. N’exposez pas votre clé au navigateur ou aux journaux.
Réponse illustrative
{
"enterpriseNumber": "0801.523.965",
"vatNumber": "BE0801.523.965",
"name": "Nyffels",
"status": { "code": "AC", "descriptions": {} },
"juridicalSituation": { "code": "000", "descriptions": {} },
"typeOfEnterprise": { "code": "2", "descriptions": {} },
"juridicalForm": null,
"juridicalFormCAC": null,
"startDate": "2023-05-01"
}Données d’exemple, pas une recherche en direct. Les dates et valeurs sont illustratives.
