Dokumentation

Eine REST-API auf der Zentralen Datenbank der Unternehmen Belgiens. JSON rein, JSON raus.

Authentifizierung

Senden Sie Ihren Schlüssel bei jeder Anfrage im Header X-API-Key.

curl -H "X-API-Key: your_key" https://companydata.nalios.be/api/v1/companies/0214596464

Endpunkte

Methode	Pfad	Beschreibung
GET	/api/v1/companies/{number}	Ein Unternehmen. Parameter: lang, establishments, vies
GET	/api/v1/companies/{number}/history	Änderungshistorie eines Unternehmens
GET	/api/v1/companies	Suche. Parameter: name, nace, city, zip, legal_form, status, limit
GET	/api/v1/autocomplete	Autovervollständigung nach Name oder Nummer. Parameter: q
GET	/api/v1/changes	Alles, was sich seit einem Zeitpunkt geändert hat. Parameter: since
GET	/api/v1/companies/{number}/accounts	Hinterlegte Jahresabschlüsse, berechnete Kennzahlen (Solvenz, Liquidität, Eigenkapitalrendite), Verwalter/Gesellschafter und über dieselben Verwalter oder Gesellschafter verbundene Unternehmen (related_companies). Parameter: limit, refresh
GET	/api/v1/companies/{number}/benchmark	Perzentil und Branchenquartile für jede Kennzahl im Vergleich zu ähnlichen Unternehmen. Parameter: depth (Länge des NACE-Präfixes)
GET	/api/v1/companies/{number}/group	Eigentumsverhältnisse um ein Unternehmen: wer es hält (owners) und was es hält (subsidiaries), mit Prozentsätzen und dem beherrschenden Eigentümer. Parameter: depth (1 bis 3 Ebenen in jede Richtung)
GET	/api/v1/people/{person_id}/mandates	Alle Unternehmen, mit denen ein Verwalter, Vertreter oder Gesellschafter verbunden ist
GET	/api/v1/people/{person_id}/network	Mehrstufiger Verwalter-/Gesellschafter-Graph, bis zu 3 Stufen. Parameter: depth
GET	/api/v1/watchlist	Listet die von Ihrem Schlüssel beobachteten Unternehmen auf
POST	/api/v1/watchlist	Fügt Ihrer Beobachtungsliste ein Unternehmen hinzu. Body: {"enterprise_number": "..."}
DELETE	/api/v1/watchlist/{number}	Entfernt ein Unternehmen aus Ihrer Beobachtungsliste
PUT	/api/v1/webhook	Legt die URL fest, die bei Änderungen eines beobachteten Unternehmens benachrichtigt wird. Body: {"url": "https://..."}
GET	/health	Dienststatus, kein Schlüssel erforderlich

Bekannte Einschränkungen

Dies sind echte Lücken, keine Fehler — gut zu wissen, bevor Sie darauf aufbauen:

• Kein Umsatzwert für kleine Unternehmen. Das belgische Recht verpflichtet das verkürzte Schema (die meisten KMU) nicht zur Offenlegung des Umsatzes. revenue und jede davon abgeleitete Kennzahl gibt es nur für Unternehmen mit dem vollständigen Schema.
• Ein Benchmark kann seine Vergleichsgruppe unbemerkt erweitern. Jede Kennzahl wird zuerst mit Unternehmen derselben Größenklasse verglichen; gibt es dort zu wenige, wird auf die gesamte Branche zurückgegriffen. Die Antwort gibt dies immer über compared_against an — prüfen Sie es, bevor Sie ein Perzentil als streng vergleichbar ansehen.
• Manche Unternehmen reichen ihren Jahresabschluss nur als PDF ein. Eine Hinterlegung, deren Modellcode auf -p endet, ist ein PDF-Modell: Die Nationalbank veröffentlicht dafür keine strukturierten Daten. Wir lesen die Kernzahlen (Bilanz, Gewinn- und Verlustrechnung, Personal) aus dem PDF selbst und behalten sie nur, wenn die Bilanz auf den Euro genau aufgeht. Solche Hinterlegungen sind mit pdf_only: true markiert, und ihre source lautet pdf, sobald Zahlen gelesen wurden. Verwaltungsratsmitglieder (Name, Funktion und Daten jedes Mandats) und Gesellschafter (Name, Art der Rechte und Anteil an den Stimmrechten) werden aus ihren Listen in der Hinterlegung gelesen, wenn diese einem bekannten Layout folgen, nie mit einer Privatadresse, und ein PDF, das nicht zuverlässig gelesen werden kann, wird ohne Zahlen zurückgegeben.
• Prozentsätze sind Bruchteile. percentage bei Gesellschaftern und Beteiligungen ist ein Anteil zwischen 0 und 1 (0.6444 bedeutet 64,44 %).
• Der Eigentumsbaum kennt nur, was vorliegt. /group wird aus den bei uns vorliegenden Jahresabschlüssen aufgebaut; eine fehlende Ebene bedeutet, dass deren Abschlüsse noch nicht erfasst sind, nicht dass niemand das Unternehmen besitzt.
• Jahresvergleichswerte stammen aus der Hinterlegung selbst. Wachstumsraten vergleichen das aktuelle Geschäftsjahr mit der Vorjahresspalte derselben Hinterlegung und sind null, wenn diese Spalte fehlt. Umsatzbasierte Kennzahlen (Margen, Umsatz pro VZÄ) gibt es nur beim vollständigen Schema.
• Der Insolvenzstatus wird nicht geprüft. legal.bankrupt ist null und legal.checked ist false für jedes Unternehmen: verwenden Sie stattdessen legal.situation aus der im KBO eingetragenen Rechtslage (Insolvenz, gerichtliche Reorganisation, Liquidation). Werten Sie ein fehlendes bankrupt nie als bestätigtes „nicht insolvent“.

Sprachen

Alle codierten Werte enthalten sowohl den Rohcode als auch eine lesbare Bezeichnung. Übergeben Sie lang=FR oder lang=NL, um die Sprache der Bezeichnungen zu wählen; Niederländisch dient als Rückfall, wenn eine Übersetzung fehlt.

Fehler

Status	Bedeutung
401	missing api_key oder invalid api_key
404	Unbekannte Unternehmensnummer
429	quota exceeded oder rate limit exceeded

Maschinenlesbar

OpenAPI-Spezifikation · Postman-Sammlung · Interaktive Referenz

Client-Bibliotheken

Minimale Clients, die Sie in Ihr Projekt übernehmen können: Python · JavaScript

Entfernte Unternehmen

Ein Unternehmen, das sein Recht auf Löschung ausgeübt hat, wird aus allen Endpunkten entfernt und liefert 404. Der Feed /api/v1/changes liefert weiterhin einen minimalen Eintrag mit "suppressed": true, damit Sie Ihren eigenen Cache bereinigen können.