COMPANYAPI

Votre première requête CompanyAPI.

Du parcours client aux données belges structurées.

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
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
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

JSON
{
  "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.

Documentation

COMPANYAPI

Créez votre prochaine connexion.

Commencez avec une clé API gratuite. Donnez une meilleure base à votre application.

Obtenir une clé API

Nous mémorisons votre choix de confidentialité. Avec votre accord, nous retenons votre langue, mesurons les visites avec Umami et enregistrons les interactions pour les relectures de session et cartes de chaleur. Chaque finalité optionnelle reste désactivée jusqu’à votre choix.

Aucun traceur publicitaire. Modifiez ou retirez vos choix à tout moment dans les Préférences de cookies.