COMPANYAPI

Unternehmensnamen suchen.

GET /companies?name={name}&limit={limit} liefert mögliche Treffer.

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

FeldBedeutungVerfügbarkeit
enterpriseNumberUnternehmensnummer wie im importierten Registerstand gespeichert.Vorhanden
vatNumberUnternehmensnummer mit BE-Präfix; keine Umsatzsteuerprüfung.Kann null sein
nameAusgewählte Unternehmensbezeichnung.Kann null sein
statusRegisterstatus mit verfügbaren Beschreibungen.Vorhanden
juridicalSituationRechtslage mit Beschreibungen.Vorhanden
typeOfEnterpriseUnternehmenstyp.Vorhanden
juridicalFormRechtsform.Kann null sein
juridicalFormCACRechtsform nach dem Gesellschafts- und Vereinigungsgesetzbuch.Kann null sein
startDateStartdatum im Register.Vorhanden

Beispielantwort

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"
  }
]

Beispieldaten, keine Live-Abfrage. Datums- und Feldwerte dienen der Illustration.

COMPANYAPI

Ihre nächste Verbindung beginnt hier.

Starten Sie mit einem kostenlosen API-Schlüssel. Geben Sie Ihrer Anwendung eine bessere Grundlage.

API-Schlüssel anfordern

Wir speichern Ihre Datenschutzentscheidung. Mit Ihrer Erlaubnis merken wir uns Ihre Sprache, messen Besuche mit Umami und erfassen Interaktionen für Sitzungswiedergaben und Heatmaps. Jeder optionale Zweck bleibt bis zu Ihrer Auswahl ausgeschaltet.

Keine Werbetracker. Ändern oder widerrufen Sie Ihre Auswahl jederzeit in den Cookie-Einstellungen.