COMPANYAPI

Rechercher les noms d’entreprise.

GET /companies?name={name}&limit={limit} renvoie des candidats.

Paramètres

name requis : au moins 3 caractères après suppression des espaces externes. limit facultatif : 20 par défaut, de 1 à 100. Une correspondance approximative ne prouve pas l’identité. X-Api-Key requis.

cURL
curl --get 'https://api.companyapi.be/companies' \
  --data-urlencode 'name=Colruyt' \
  --data-urlencode 'limit=5' \
  --header "X-Api-Key: $COMPANYAPI_KEY"

Réponse

200 renvoie un tableau d’objets de base. Aucun résultat donne un tableau vide, pas 404. Les noms proviennent des dénominations disponibles non supprimées. Choisissez le numéro avant les détails.

Statuts et limites

400 : nom absent/trop court ou limit hors 1–100. 401 : authentification. 429 : limitation. Une requête compte indépendamment du nombre de candidats.

Informations de base

ChampSignificationDisponibilité
enterpriseNumberNuméro d’entreprise tel qu’enregistré dans la source importée.Présent
vatNumberNuméro préfixé par BE ; pas une validation TVA.Peut être null
nameDénomination sélectionnée.Peut être null
statusStatut du registre et descriptions disponibles.Présent
juridicalSituationSituation juridique et descriptions.Présent
typeOfEnterpriseType d’entreprise.Présent
juridicalFormForme juridique.Peut être null
juridicalFormCACForme juridique selon le Code des sociétés et des associations.Peut être null
startDateDate de début au registre.Présent

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.

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.