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 --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
| Champ | Signification | Disponibilité |
|---|---|---|
enterpriseNumber | Numéro d’entreprise tel qu’enregistré dans la source importée. | Présent |
vatNumber | Numéro préfixé par BE ; pas une validation TVA. | Peut être null |
name | Dénomination sélectionnée. | Peut être null |
status | Statut du registre et descriptions disponibles. | Présent |
juridicalSituation | Situation juridique et descriptions. | Présent |
typeOfEnterprise | Type d’entreprise. | Présent |
juridicalForm | Forme juridique. | Peut être null |
juridicalFormCAC | Forme juridique selon le Code des sociétés et des associations. | Peut être null |
startDate | Date de début au registre. | Présent |
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.
