Parameter
name erforderlich: mindestens 3 Zeichen nach Entfernen äußerer Leerzeichen. limit optional: Standard 20, Bereich 1–100. Unscharfe Treffer beweisen keine Identität. X-Api-Key erforderlich.
curl --get 'https://api.companyapi.be/companies' \
--data-urlencode 'name=Colruyt' \
--data-urlencode 'limit=5' \
--header "X-Api-Key: $COMPANYAPI_KEY"Antwort
200 liefert eine Liste von Basisobjekten. Keine Treffer ergibt eine leere Liste, nicht 404. Namen stammen aus verfügbaren, nicht gelöschten Bezeichnungen. Nummer vor dem Detailabruf auswählen.
Status und Limits
400: fehlender/kurzer Name oder limit außerhalb 1–100. 401: Authentifizierung. 429: Ratenlimit. Die Anfrage zählt unabhängig von der Trefferzahl.
Basisinformationen
| Feld | Bedeutung | Verfügbarkeit |
|---|---|---|
enterpriseNumber | Unternehmensnummer wie im importierten Registerstand gespeichert. | Vorhanden |
vatNumber | Unternehmensnummer mit BE-Präfix; keine Umsatzsteuerprüfung. | Kann null sein |
name | Ausgewählte Unternehmensbezeichnung. | Kann null sein |
status | Registerstatus mit verfügbaren Beschreibungen. | Vorhanden |
juridicalSituation | Rechtslage mit Beschreibungen. | Vorhanden |
typeOfEnterprise | Unternehmenstyp. | Vorhanden |
juridicalForm | Rechtsform. | Kann null sein |
juridicalFormCAC | Rechtsform nach dem Gesellschafts- und Vereinigungsgesetzbuch. | Kann null sein |
startDate | Startdatum im Register. | Vorhanden |
Beispielantwort
[
{
"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"
}
]Beispieldaten, keine Live-Abfrage. Datums- und Feldwerte dienen der Illustration.
