Dokumentation der Firmenbuch-API

Jeder Endpunkt mit Methode, Pfad, Parametern, Aufruf, einer Beispielantwort für die RELACON GmbH, den Feldern der Antwort und den Fehlercodes. Beträge stehen in den Beispielen nur als Platzhalter.

Inhalt

Zugang und Authentifizierung

Den Schlüssel legen Sie angemeldet im Konto unter „API und MCP“ an. Er beginnt mit fbd_ und wird einmal gezeigt. Jeder Aufruf trägt ihn im Header Authorization als Bearer.

Authorization: Bearer fbd_…

Kontingent je UTC-Monat: Free 50, Pro 50, Business 1.000 Abrufe. Jeder Aufruf kostet einen Abruf, auch Suche, Kundencheck und jedes PDF. Keine Gebühr je Abfrage.
Jede Antwort trägt x-ratelimit-limit, x-ratelimit-remaining und x-ratelimit-reset. Sind die Abrufe verbraucht, antwortet die API mit 429 und nennt im Rumpf limit und resetAt.
Endet ein Abo, läuft derselbe Schlüssel mit den Grenzen von Free weiter.
Eine eigene Testumgebung gibt es nicht: der Gratis-Schlüssel läuft auf den Live-Daten.

Basisadresse: https://api.firmenbuchdaten.at/v1

Die bisherige Adresse https://firmenbuchdaten.at/api/v1 bleibt gültig und führt zu denselben Antworten. Unter https://api.firmenbuchdaten.at gibt es nur die API, keine Seiten.

Unternehmens-API

Findet eine Firma über den Namen und liefert ihre Daten aus dem Firmenbuch: Name, Sitz, Rechtsform, Status, die eingereichten Jahresabschlüsse und Edikte im Insolvenzverfahren. Für die Anlage eines neuen Kunden oder Lieferanten.

GET `/v1/companies`

Firmen nach Namen suchen. Treffer aus unserem Verzeichnis, ohne Abfrage beim Firmenbuch, mit den Filtern der erweiterten Suche. Mindestens q oder ein Filter. Eine Seite ist ein Abruf. Andere Filter (Bundesland, Bezirk, ÖNACE) beantwortet die API mit 400 unsupported_filter.

Weiterhin gültig: https://firmenbuchdaten.at/api/v1/companies

Tarif: Alle Tarife

Parameter

Name	Typ	Pflicht	Beschreibung
`q`	string, query	nein	Name, Teil des Namens (mindestens drei Zeichen) oder Firmenbuchnummer
`rechtsform`	string, query	nein	Rechtsform wie im Firmenbuch, z. B. Gesellschaft mit beschränkter Haftung
`sitz`	string, query	nein	Sitz wie im Firmenbuch, z. B. Wien
`gkl`	string, query	nein	Größenklasse des letzten Abschlusses: W, K, M oder G
`seit`	string, query	nein	Nur Firmen mit einem Abschluss eingereicht ab diesem Tag (JJJJ-MM-TT)
`limit`	integer, query	nein	Treffer je Seite, 1 bis 50, Vorgabe 25
`cursor`	string, query	nein	nextCursor der vorigen Antwort; höchstens 20 Seiten

Aufruf

curl -H "Authorization: Bearer fbd_…" \
  "https://api.firmenbuchdaten.at/v1/companies?q=relacon"

Antwort

{
  "results": [
    {
      "fnr": "508415w",
      "name": "RELACON GmbH",
      "sitz": "Klosterneuburg",
      "rechtsform": "Gesellschaft mit beschränkter Haftung",
      "status": "eingetragen"
    }
  ],
  "nextCursor": null
}

Feld	Typ	Beschreibung
`results`	array	Treffer der Seite
`results[].fnr`	string	Firmenbuchnummer mit Prüfbuchstabe
`results[].name`	string	Firmenwortlaut
`results[].sitz`	string	Sitz laut Firmenbuch
`results[].rechtsform`	string	Rechtsform
`results[].status`	string	eingetragen oder gelöscht
`nextCursor`	string \| null	Wert für cursor der nächsten Seite, null am Ende

Fehler

Status	Code	Bedeutung
400	`query_too_short`	Kein Suchbegriff und kein Filter, oder ein Suchbegriff kürzer als drei Zeichen.
400	`unsupported_filter`	Ein Parameter, den die Suche nicht kennt; die Antwort nennt die unterstützten.
400	`cursor_too_deep`	Mehr als 20 Seiten; Filter enger fassen.

GET `/v1/companies/{fnr}`

Firmendaten. Name, Sitz, Rechtsform, Status, die Liste der Jahresabschlüsse mit Stichtag, Größenklasse und Einreichtag, das letzte Vollzugsdatum und Edikte zu Verkäufen und Verpachtungen im Insolvenzverfahren. Keine Geschäftsführung, keine Gesellschafter; ein Edikt nennt die Insolvenzverwaltung so, wie die Ediktsdatei sie veröffentlicht.

Weiterhin gültig: https://firmenbuchdaten.at/api/v1/companies/{fnr}

Tarif: Alle Tarife. Business zusätzlich: Branche (ÖNACE) laut Statistik Austria, öffentliche Aufträge, Sanktionen der FMA, Kreditinstitut laut OeNB und die Zahl der Verflechtungen.

Parameter

Name	Typ	Pflicht	Beschreibung
`fnr`	string, Pfad	ja	Firmenbuchnummer mit Prüfbuchstabe, z. B. 508415w

Aufruf

curl -H "Authorization: Bearer fbd_…" \
  "https://api.firmenbuchdaten.at/v1/companies/508415w"

Antwort

{
  "fnr": "508415w",
  "name": "RELACON GmbH",
  "sitz": "Klosterneuburg",
  "rechtsform": "Gesellschaft mit beschränkter Haftung",
  "status": "eingetragen",
  "soleTrader": false,
  "annualAccounts": [
    {
      "stichtag": "2025-12-31",
      "sizeClass": "W",
      "filed": "2026-01-21",
      "formats": [
        "pdf",
        "xml"
      ]
    },
    {
      "stichtag": "2024-12-31",
      "sizeClass": "W",
      "filed": "2025-05-03",
      "formats": [
        "pdf",
        "xml"
      ]
    }
  ],
  "lastChange": null,
  "insolvencyNotices": [],
  "retrievedAt": "2026-10-29T07:49:23.526Z",
  "source": "Österreichisches Firmenbuch, Republik Österreich, vertreten durch das BMJ, offene Daten unter CC BY 4.0"
}

Feld	Typ	Beschreibung
`fnr`	string	Firmenbuchnummer mit Prüfbuchstabe
`name`	string	Firmenwortlaut
`sitz`	string	Sitz laut Firmenbuch
`rechtsform`	string	Rechtsform
`status`	string	Status, z. B. eingetragen oder gelöscht
`soleTrader`	boolean	true bei Einzelunternehmen, deren Name der einer Person ist
`annualAccounts[]`	array	Eingereichte Jahresabschlüsse: stichtag, sizeClass, filed, formats
`lastChange`	string \| null	Letztes Vollzugsdatum aus der Änderungsliste des Firmenbuchs
`insolvencyNotices[]`	array	Edikte: published, court, caseNo, kind, transaction, description, administrator
`retrievedAt`	string	Zeitpunkt des letzten Abrufs beim Firmenbuch (ISO 8601)
`source`	string	Quellenangabe, bei jeder Anzeige mitführen
`lei[]`	array	LEI laut GLEIF; leer, bis die GLEIF-Daten geladen sindnur Business
`oenace`	object \| null	Branche nach ÖNACE laut Statistik Austrianur Business
`publicAwards`	object \| null	Öffentliche Aufträge laut data.gv.atnur Business
`fmaSanctions[]`	array	Sanktionen der FMA gegen die Firma: title, date, urlnur Business
`bank`	object \| null	Kreditinstitut laut OeNBnur Business
`network`	object \| null	Verflechtungen: persons (natürliche Personen mit Funktionen in anderen aktiven Firmen) und companies (Zahl dieser Firmen), nur Zahlennur Business
`persons`	string	Pfad zu den Funktionen dieser Firma (Personen-API)nur Business

Fehler

Status	Code	Bedeutung
400	`invalid_fnr`	Keine gültige Firmenbuchnummer, etwa ein falscher Prüfbuchstabe.
404	`not_found`	Die Firmenbuchnummer gibt es nicht.

GET `/v1/companies/{fnr}/gewerbe`

Gewerbe laut GISA. Gewerbeberechtigungen einer Firma aus dem Gewerbeinformationssystem Austria: Wortlaut, Gewerbeschlüssel, Standort, Status (aufrecht, ruhend, beendet), Beginn und Ende. Eine Einzelabfrage je Aufruf über die öffentliche GISA-Schnittstelle, 7 Tage zwischengespeichert, zugeordnet nur über die Firmenbuchnummer. Keine Geschäftsführer, keine Listen, nicht für Einzelunternehmen.

Weiterhin gültig: https://firmenbuchdaten.at/api/v1/companies/{fnr}/gewerbe

Tarif: Pro und Business.

Parameter

Name	Typ	Pflicht	Beschreibung
`fnr`	string, Pfad	ja	Firmenbuchnummer mit Prüfbuchstabe, z. B. 508415w

Aufruf

curl -H "Authorization: Bearer fbd_…" \
  "https://api.firmenbuchdaten.at/v1/companies/508415w/gewerbe"

Antwort

{
  "fnr": "508415w",
  "fetchedAt": "<JJJJ-MM-TTThh:mm:ssZ>",
  "trades": [
    {
      "gisaZahl": "<GISA-Zahl>",
      "wortlaut": "<Wortlaut>",
      "gewerbeschluessel": "<Schlüssel>",
      "plz": "<PLZ>",
      "ort": "<Ort>",
      "status": "aktiv",
      "beginn": "<JJJJ-MM-TT>",
      "ende": null
    }
  ],
  "source": "Austrian trade information system (GISA), Federal Ministry of Economy, Energy and Tourism, single query through the public interface"
}

Feld	Typ	Beschreibung
`fnr`	string	Firmenbuchnummer
`fetchedAt`	string	Zeitpunkt der Abfrage bei GISA
`trades[]`	array	gisaZahl, wortlaut, gewerbeschluessel, plz, ort, status, beginn, ende
`source`	string	Quellenangabe

Fehler

Status	Code	Bedeutung
400	`invalid_fnr`	Keine gültige Firmenbuchnummer.
403	`plan`	Nur mit Pro oder Business.
404	`unknown_company`	Die Firma ist noch nicht in unserer Datenbank. Erst die Firma abrufen, dann GISA.
404	`sole_trader`	Für Einzelunternehmen gibt es keine GISA-Abfrage.
429	`account_limit`	Tagesgrenze der GISA-Abfragen dieses Kontos erreicht.
429	`in_progress`	Diese Firma wird gerade abgefragt; in einer Minute steht das Ergebnis im Zwischenspeicher.
503	`paused`	GISA-Abfragen sind gerade pausiert (Minuten- oder Tageskontingent, oder GISA antwortet nicht).

Jahresabschluss-API

Liefert Bilanz und GuV eines Jahres so, wie die Firma sie eingereicht hat, mit unseren Kennzahlen, und den Jahresabschluss als PDF. Für Bonitätsprüfung im eigenen Haus, Akten und Berichte.

GET `/v1/companies/{fnr}/financials`

Bilanz, GuV und Kennzahlen. Je Jahr die Posten der Bilanz und, wo veröffentlicht, der GuV in Cent, unverändert aus dem Firmenbuch, dazu unsere Kennzahlen. load=1 lädt ein noch fehlendes Jahr beim Firmenbuch nach.

Weiterhin gültig: https://firmenbuchdaten.at/api/v1/companies/{fnr}/financials

Tarif: Pro und Business: alle Firmen. Free: nur die Firma Ihrer kostenlosen Abfrage.

Parameter

Name	Typ	Pflicht	Beschreibung
`fnr`	string, Pfad	ja	Firmenbuchnummer mit Prüfbuchstabe, z. B. 508415w
`load`	integer, query	nein	1 = ein fehlendes Jahr nachladen

Aufruf

curl -H "Authorization: Bearer fbd_…" \
  "https://api.firmenbuchdaten.at/v1/companies/508415w/financials?load=1"

Antwort

{
  "fnr": "508415w",
  "name": "RELACON GmbH",
  "years": [
    {
      "stichtag": "2025-12-31",
      "sizeClass": "W",
      "hasProfitAndLoss": false,
      "positionsCents": {
        "<Posten>": "<Betrag in Cent>"
      },
      "evaluation": {
        "<Kennzahl>": "<Wert>"
      }
    }
  ],
  "notLoaded": [],
  "note": "positionsCents: register figures in euro cents, unchanged. evaluation: computed by firmenbuchdaten.at, not part of the register.",
  "source": "Österreichisches Firmenbuch, Republik Österreich, vertreten durch das BMJ, offene Daten unter CC BY 4.0"
}

Feld	Typ	Beschreibung
`fnr`	string	Firmenbuchnummer
`name`	string	Firmenwortlaut
`years[]`	array	Je geladenes Jahr: stichtag, sizeClass, hasProfitAndLoss, positionsCents, evaluation
`years[].positionsCents`	object	Posten des Firmenbuchs in Euro-Cent, unverändert
`years[].evaluation`	object	Kennzahlen, berechnet von firmenbuchdaten.at, nicht Teil des Firmenbuchs
`notLoaded[]`	array	Stichtage, die noch nicht geladen sind (load=1 lädt einen)
`note`	string	Hinweis, welche Zahlen aus dem Firmenbuch stammen und welche von uns
`source`	string	Quellenangabe

Fehler

Status	Code	Bedeutung
403	`plan_without_financials`	Free: Zahlen nur für die Firma der kostenlosen Abfrage. Pro oder Business für alle Firmen.
404	`not_found`	Die Firmenbuchnummer gibt es nicht.

GET `/v1/companies/{fnr}/documents/{stichtag}`

Jahresabschluss als PDF. Der Jahresabschluss, wie er beim Firmenbuch eingereicht wurde. Höchstens 20 PDFs je Schlüssel und Stunde.

Weiterhin gültig: https://firmenbuchdaten.at/api/v1/companies/{fnr}/documents/{stichtag}

Tarif: Pro und Business.

Parameter

Name	Typ	Pflicht	Beschreibung
`fnr`	string, Pfad	ja	Firmenbuchnummer mit Prüfbuchstabe, z. B. 508415w
`stichtag`	string, Pfad	ja	Bilanzstichtag im Format JJJJ-MM-TT

Aufruf

curl -H "Authorization: Bearer fbd_…" \
  "https://api.firmenbuchdaten.at/v1/companies/508415w/documents/2025-12-31" \
  -o abschluss.pdf

Antwort

Die PDF-Datei (application/pdf), wie beim Firmenbuch eingereicht.

Fehler

Status	Code	Bedeutung
400	`invalid`	Firmenbuchnummer oder Stichtag ungültig.
403	`plan_without_financials`	PDFs gibt es mit Pro oder Business.
429	`rate`	Mehr als 20 PDFs in einer Stunde.

Personen-API

Zeigt, wer in einer Firma Geschäftsführung, Prokura oder eine andere Funktion laut Firmenbuch hat und in welchen Firmen dieselbe Person noch eingetragen ist. Für die Prüfung von Geschäftspartnern, nur mit Business. Jeder Aufruf wird 90 Tage protokolliert.

GET `/v1/persons`

Personen suchen. Personen mit Funktionen im Firmenbuch nach Namen, höchstens 20 Treffer mit Name und Zahl der Firmen. Mit geburtsdatum genau die eine Person mit diesem Namen und Geburtstag. Das Geburtsdatum selbst speichern wir nicht und geben es nicht zurück.

Weiterhin gültig: https://firmenbuchdaten.at/api/v1/persons

Tarif: Business.

Parameter

Name	Typ	Pflicht	Beschreibung
`name`	string, query	ja	Name oder Teil des Namens
`geburtsdatum`	string, query	nein	Geburtsdatum JJJJ-MM-TT, für einen genauen Treffer

Aufruf

curl -H "Authorization: Bearer fbd_…" \
  "https://api.firmenbuchdaten.at/v1/persons?name=<Name>"

Antwort

{
  "results": [
    {
      "key": "<key>",
      "name": "<Name>",
      "companies": 2,
      "legalEntity": false
    }
  ],
  "source": "Österreichisches Firmenbuch, Republik Österreich, vertreten durch das BMJ, offene Daten unter CC BY 4.0"
}

Feld	Typ	Beschreibung
`results[].key`	string	Schlüssel für /v1/persons/{key}
`results[].name`	string	Name wie im Firmenbuch
`results[].companies`	integer	Zahl der Firmen mit einer Funktion
`results[].legalEntity`	boolean	true bei juristischen Personen (z. B. eine GmbH als Gesellschafterin)
`source`	string	Quellenangabe

Fehler

Status	Code	Bedeutung
400	`name_too_short`	Kein Namensteil mit mindestens drei Zeichen.
403	`plan_without_persons`	Personen gibt es über die API nur mit Business.
429	`person_rate`	Mehr als 30 Personenabrufe in einer Stunde oder 100 an einem Tag (gemeinsam mit der Personensuche der Website).

GET `/v1/persons/{key}`

Funktionen einer Person. Aktuelle Funktionen mit Firma, Firmenbuchnummer, Funktion und seit wann, dazu Funktionen, die nicht mehr im Firmenbuchauszug stehen, mit dem Tag, an dem wir das bemerkt haben.

Weiterhin gültig: https://firmenbuchdaten.at/api/v1/persons/{key}

Tarif: Business.

Parameter

Name	Typ	Pflicht	Beschreibung
`key`	string, Pfad	ja	Schlüssel der Person aus einer Suche (24 Zeichen)

Aufruf

curl -H "Authorization: Bearer fbd_…" \
  "https://api.firmenbuchdaten.at/v1/persons/<key>"

Antwort

{
  "key": "<key>",
  "name": "<Name>",
  "legalEntity": false,
  "functions": [
    {
      "fnr": "508415w",
      "company": "RELACON GmbH",
      "sitz": "Klosterneuburg",
      "companyStatus": "eingetragen",
      "code": "GF",
      "function": "<Funktion>",
      "since": "<JJJJ-MM-TT>",
      "representation": "<Vertretung>"
    }
  ],
  "endedFunctions": [],
  "source": "Österreichisches Firmenbuch, Republik Österreich, vertreten durch das BMJ, offene Daten unter CC BY 4.0"
}

Feld	Typ	Beschreibung
`key`	string	Schlüssel der Person
`name`	string	Name wie im Firmenbuch
`legalEntity`	boolean	true bei juristischen Personen
`functions[]`	array	fnr, company, sitz, companyStatus, code, function, since, representation
`endedFunctions[]`	array	fnr, company, code, function, since, notInExtractSince (Tag, an dem die Funktion nicht mehr im Auszug stand)
`source`	string	Quellenangabe

Fehler

Status	Code	Bedeutung
400	`invalid_key`	Kein gültiger Schlüssel.
403	`plan_without_persons`	Personen gibt es über die API nur mit Business.
404	`not_found`	Keine Person mit diesem Schlüssel.
429	`person_rate`	Stunden- oder Tagesgrenze der Personenabrufe erreicht.

GET `/v1/companies/{fnr}/persons`

Funktionen einer Firma. Wer in dieser Firma eine Funktion hat (Geschäftsführung, Prokura, Gesellschafter laut Auszug, Aufsichtsrat), mit seit wann und Vertretung, und wer nicht mehr im Auszug steht. Gesellschafteranteile führen wir nicht.

Weiterhin gültig: https://firmenbuchdaten.at/api/v1/companies/{fnr}/persons

Tarif: Business.

Parameter

Name	Typ	Pflicht	Beschreibung
`fnr`	string, Pfad	ja	Firmenbuchnummer mit Prüfbuchstabe, z. B. 508415w

Aufruf

curl -H "Authorization: Bearer fbd_…" \
  "https://api.firmenbuchdaten.at/v1/companies/508415w/persons"

Antwort

{
  "fnr": "508415w",
  "functions": [
    {
      "key": "<key>",
      "name": "<Name>",
      "legalEntity": false,
      "code": "GF",
      "function": "<Funktion>",
      "since": "<JJJJ-MM-TT>",
      "representation": "<Vertretung>"
    }
  ],
  "endedFunctions": [],
  "source": "Österreichisches Firmenbuch, Republik Österreich, vertreten durch das BMJ, offene Daten unter CC BY 4.0"
}

Feld	Typ	Beschreibung
`fnr`	string	Firmenbuchnummer
`functions[]`	array	key, name, legalEntity, code, function, since, representation
`endedFunctions[]`	array	key, name, legalEntity, code, function, since, notInExtractSince
`source`	string	Quellenangabe

Fehler

Status	Code	Bedeutung
400	`invalid_fnr`	Keine gültige Firmenbuchnummer.
403	`plan_without_persons`	Personen gibt es über die API nur mit Business.
429	`person_rate`	Stunden- oder Tagesgrenze der Personenabrufe erreicht.

Änderungslisten-API

Liefert die Firmen mit einer neuen Eintragung, einer Löschung, einem neu eingereichten Jahresabschluss oder einem Edikt in einem Zeitraum, oder nur für die Firmen, die Sie beobachten. Damit bleibt Ihr CRM aktuell, ohne jede Firma einzeln abzufragen.

GET `/v1/changes`

Änderungen im Zeitraum. Firmen mit einer Änderung in einem Zeitraum von höchstens 31 Tagen, 100 je Seite. art: aenderung (neueste Eintragung im Zeitraum, auch neue Firmen), loeschung, abschluss (Jahresabschluss eingereicht), edikt. Je Firma zählt die neueste Eintragung, nicht jede einzelne; Neueintragungen getrennt und Funktionswechsel sind geplant.

Weiterhin gültig: https://firmenbuchdaten.at/api/v1/changes

Tarif: Business. Eine Seite ist ein Abruf.

Parameter

Name	Typ	Pflicht	Beschreibung
`since`	string, query	ja	Erster Tag, JJJJ-MM-TT
`until`	string, query	nein	Letzter Tag, höchstens 31 Tage nach since
`art`	string, query	nein	aenderung (Vorgabe), loeschung, abschluss oder edikt
`rechtsform`	string, query	nein	Rechtsform wie im Firmenbuch (nicht mit edikt)
`sitz`	string, query	nein	Sitz wie im Firmenbuch (nicht mit edikt)
`cursor`	string, query	nein	nextCursor der vorigen Antwort

Aufruf

curl -H "Authorization: Bearer fbd_…" \
  "https://api.firmenbuchdaten.at/v1/changes?since=2026-11-01&until=2026-11-07&art=aenderung"

Antwort

{
  "since": "2026-11-01",
  "until": "2026-11-07",
  "art": "aenderung",
  "changes": [
    {
      "fnr": "508415w",
      "name": "RELACON GmbH",
      "kind": "aenderung",
      "date": "<JJJJ-MM-TT>",
      "sitz": "Klosterneuburg",
      "rechtsform": "Gesellschaft mit beschränkter Haftung",
      "description": "Eintragung im Firmenbuch"
    }
  ],
  "nextCursor": "<Cursor>",
  "source": "Österreichisches Firmenbuch, Republik Österreich, vertreten durch das BMJ, offene Daten unter CC BY 4.0"
}

Feld	Typ	Beschreibung
`since`	string	Erster Tag
`until`	string	Letzter Tag
`art`	string	Abgefragte Art
`changes[]`	array	fnr, name, kind, date (Tag der Eintragung, Einreichung oder Bekanntmachung), sitz, rechtsform, description
`nextCursor`	string \| null	Wert für cursor der nächsten Seite, null am Ende
`source`	string	Quellenangabe

Fehler

Status	Code	Bedeutung
400	`invalid_since`	since fehlt oder ist kein Datum.
400	`range_too_long`	Zeitraum länger als 31 Tage.
400	`kind_not_available`	art=neueintragung oder art=funktion: geplant, heute nicht ableitbar.
400	`unsupported_filter`	Ein Parameter, den die Liste nicht kennt (etwa bundesland, bezirk, oenace).
403	`plan_without_changes`	Die Änderungsliste gibt es mit Business; die Watchlist mit jedem Tarif.

GET `/v1/watchlist/changes`

Änderungen der beobachteten Firmen. Dasselbe für die Firmen, die Ihr Konto beobachtet (Free 5, Pro 25, Business 250): neueste Eintragung, eingereichter Jahresabschluss und Edikte seit since, höchstens 93 Tage zurück.

Weiterhin gültig: https://firmenbuchdaten.at/api/v1/watchlist/changes

Tarif: Alle Tarife.

Parameter

Name	Typ	Pflicht	Beschreibung
`since`	string, query	ja	Erster Tag, JJJJ-MM-TT

Aufruf

curl -H "Authorization: Bearer fbd_…" \
  "https://api.firmenbuchdaten.at/v1/watchlist/changes?since=2026-11-01"

Antwort

{
  "since": "2026-11-01",
  "changes": [
    {
      "fnr": "508415w",
      "name": "RELACON GmbH",
      "kind": "abschluss",
      "date": "<JJJJ-MM-TT>",
      "sitz": "Klosterneuburg",
      "rechtsform": "Gesellschaft mit beschränkter Haftung",
      "description": "Jahresabschluss eingereicht"
    }
  ],
  "source": "Österreichisches Firmenbuch, Republik Österreich, vertreten durch das BMJ, offene Daten unter CC BY 4.0"
}

Feld	Typ	Beschreibung
`since`	string	Erster Tag
`changes[]`	array	wie bei /v1/changes, neueste zuerst
`source`	string	Quellenangabe

Fehler

Status	Code	Bedeutung
400	`invalid_since`	since fehlt, ist kein Datum oder liegt in der Zukunft.
400	`range_too_long`	since liegt zu weit zurück; die Antwort nennt den frühesten Tag.

Kundencheck-API

Gibt eine Ampel mit Zahlungsziel und den Gründen dafür, aus Firmenbuch, Offenlegung und Ediktsdatei. Für die Frage: Vorkasse oder Rechnung?

GET `/v1/kundencheck/{fnr}`

Kundencheck. Die Ampel des Kundenchecks mit Zahlungsziel und jedem Signal (Status, Alter, Offenlegung, Größenklasse, Änderungen, Edikte), jeweils mit Text auf Deutsch und Englisch. Keine Beträge, keine Bonitätsauskunft.

Weiterhin gültig: https://firmenbuchdaten.at/api/v1/kundencheck/{fnr}

Tarif: Alle Tarife. Business zusätzlich: Abgleich mit der EU-Sanktionsliste.

Parameter

Name	Typ	Pflicht	Beschreibung
`fnr`	string, Pfad	ja	Firmenbuchnummer mit Prüfbuchstabe, z. B. 508415w

Aufruf

curl -H "Authorization: Bearer fbd_…" \
  "https://api.firmenbuchdaten.at/v1/kundencheck/508415w"

Antwort

{
  "fnr": "508415w",
  "name": "RELACON GmbH",
  "sitz": "Klosterneuburg",
  "rechtsform": "Gesellschaft mit beschränkter Haftung",
  "light": "<green | yellow | red>",
  "lightText": {
    "de": "<Text>",
    "en": "<text>"
  },
  "paymentTerm": "<vorkasse | 14 | 30>",
  "paymentTermText": {
    "de": "<Text>",
    "en": "<text>"
  },
  "registerRead": true,
  "signals": [
    {
      "key": "status",
      "level": "ok",
      "data": {
        "status": "active"
      },
      "de": "<Text>",
      "en": "<text>"
    }
  ],
  "sanctions": null,
  "fmaSanctions": [],
  "note": "<Hinweis>",
  "page": "https://firmenbuchdaten.at/kundencheck/508415w",
  "source": "Österreichisches Firmenbuch, Republik Österreich, vertreten durch das BMJ, offene Daten unter CC BY 4.0; Edikte: Republik Österreich, vertreten durch das BMJ (Ediktsdatei)"
}

Feld	Typ	Beschreibung
`fnr`	string	Firmenbuchnummer
`name`	string	Firmenwortlaut
`sitz`	string	Sitz laut Firmenbuch
`rechtsform`	string	Rechtsform
`light`	string	green, yellow oder red
`lightText`	object	Text zur Ampel, de und en
`paymentTerm`	string	vorkasse, 14 oder 30 (Tage)
`paymentTermText`	object	Text zum Zahlungsziel, de und en
`registerRead`	boolean	true, wenn das Firmenbuch für diese Prüfung gelesen wurde
`signals[]`	array	Jedes Signal mit key, level, data und Text de/en
`sanctions`	object \| null	Abgleich mit der EU-Sanktionsliste; null ohne Business oder solange keine Liste geladen ist
`fmaSanctions[]`	array	Sanktionen der FMA gegen die Firma
`note`	string	Hinweis: keine Bonitätsauskunft
`page`	string	Adresse der Kundencheck-Seite
`source`	string	Quellenangabe

Fehler

Status	Code	Bedeutung
400	`invalid_fnr`	Keine gültige Firmenbuchnummer.
403	`sole_trader`	Einzelunternehmen werden nicht geprüft, ihr Name ist der einer Person.
404	`not_found`	Die Firmenbuchnummer gibt es nicht.

UID-Prüfung (VIES)

Prüft eine UID-Nummer aus der EU bei VIES der Europäischen Kommission und nennt Name und Anschrift laut Mitgliedstaat, dazu einen vorsichtigen Abgleich mit dem Firmenbuch. Kostet keinen Abruf des Monats.

GET `/v1/uid/{uid}`

UID-Nummer prüfen. Zuerst Format und bei österreichischen Nummern die Prüfziffer (ohne Anfrage bei VIES), dann VIES. state: gueltig, ungueltig oder unerreichbar (VIES oder der Mitgliedstaat antwortet gerade nicht; nie geraten). Antworten liegen 24 Stunden im Zwischenspeicher, unerreichbar nie. match nennt eine Firma unseres Bestands mit gleichem Namen nur als wahrscheinlich, weil das Firmenbuch keine UID führt. Zählt nicht gegen das Monatskontingent; höchstens 100 Prüfungen je Stunde und Konto.

Weiterhin gültig: https://firmenbuchdaten.at/api/v1/uid/{uid}

Tarif: Alle Tarife, ohne Abruf aus dem Kontingent.

Parameter

Name	Typ	Pflicht	Beschreibung
`uid`	string, Pfad	ja	UID-Nummer mit Länderkürzel, z. B. ATU12345678

Aufruf

curl -H "Authorization: Bearer fbd_…" \
  "https://api.firmenbuchdaten.at/v1/uid/ATU74215057"

Antwort

{
  "uid": "ATU74215057",
  "state": "gueltig",
  "name": "RELACON GmbH",
  "address": "Preiseckergasse 5-7/3/12 AT-3420 Kritzendorf",
  "checkedAt": "2026-11-08T16:13:02.222Z",
  "match": {
    "fnr": "508415w",
    "name": "RELACON GmbH",
    "sitz": "Klosterneuburg",
    "confidence": "wahrscheinlich",
    "seatInAddress": false
  },
  "source": "VIES, European Commission (free, as of each query)"
}

Feld	Typ	Beschreibung
`uid`	string	Die UID in kompakter Form
`state`	string	gueltig, ungueltig oder unerreichbar
`name`	string \| null	Name laut VIES; null, wenn der Mitgliedstaat ihn nicht mitteilt
`address`	string \| null	Anschrift laut VIES
`checkedAt`	string	Zeitpunkt der Antwort von VIES (ISO 8601)
`match`	object \| null	fnr, name, sitz, confidence (immer wahrscheinlich), seatInAddress
`source`	string	Quellenangabe

Fehler

Status	Code	Bedeutung
400	`invalid_uid`	Kein Länderkürzel der EU oder falsche Länge.
400	`invalid_check_digit`	Österreichische UID mit falscher Prüfziffer.
429	`uid_rate`	Mehr als 100 UID-Prüfungen in einer Stunde; Retry-After nennt die Sekunden.
429	`vies_busy`	Die gemeinsame Obergrenze für Anfragen an VIES ist für diese Minute erreicht.

Fehler, die jeder Aufruf haben kann

Status	Code	Bedeutung
401	`missing_or_invalid_key`	Kein oder ein ungültiger Schlüssel im Header Authorization.
401	`invalid_key`	Der Schlüssel ist widerrufen oder unbekannt.
429	`monthly_credits_used`	Die Abrufe dieses UTC-Monats sind verbraucht. Die Antwort nennt limit und resetAt (Unix-Sekunden, Beginn des nächsten Monats), dazu die Header x-ratelimit-limit, x-ratelimit-remaining und x-ratelimit-reset.
503	`register_busy`	Das Firmenbuch ist gerade pausiert und die Firma noch nicht in unserer Datenbank. Später noch einmal.

HTTP/1.1 429 Too Many Requests
x-ratelimit-limit: 50
x-ratelimit-remaining: 0
x-ratelimit-reset: 1796083200

{ "error": "monthly_credits_used", "limit": 50, "resetAt": 1796083200 }

MCP für KI-Assistenten

Damit ein KI-Assistent wie ChatGPT, Claude oder Cursor selbst im Firmenbuch nachsehen kann. Streamable HTTP unter https://api.firmenbuchdaten.at/mcp (oder https://firmenbuchdaten.at/mcp), derselbe Schlüssel im Header Authorization. Werkzeuge: search_companies, get_company, get_financials. Jeder Werkzeugaufruf kostet einen Abruf.

{
  "mcpServers": {
    "firmenbuchdaten": {
      "type": "http",
      "url": "https://api.firmenbuchdaten.at/mcp",
      "headers": { "Authorization": "Bearer fbd_…" }
    }
  }
}

Zur API-Übersicht API-Preise

Quelle: Österreichisches Firmenbuch, Republik Österreich, vertreten durch das BMJ, offene Daten unter CC BY 4.0.

Dokumentation der Firmenbuch-API

Zugang und Authentifizierung

Unternehmens-API

GET /v1/companies

Parameter

Aufruf

Antwort

Fehler

GET /v1/companies/{fnr}

Parameter

Aufruf

Antwort

Fehler

GET /v1/companies/{fnr}/gewerbe

Parameter

Aufruf

Antwort

Fehler

Jahresabschluss-API

GET /v1/companies/{fnr}/financials

Parameter

Aufruf

Antwort

Fehler

GET /v1/companies/{fnr}/documents/{stichtag}

Parameter

Aufruf

Antwort

Fehler

Personen-API

GET /v1/persons

Parameter

Aufruf

Antwort

Fehler

GET /v1/persons/{key}

Parameter

Aufruf

Antwort

Fehler

GET /v1/companies/{fnr}/persons

Parameter

Aufruf

Antwort

Fehler

Änderungslisten-API

GET /v1/changes

Parameter

Aufruf

Antwort

Fehler

GET /v1/watchlist/changes

Parameter

Aufruf

Antwort

Fehler

Kundencheck-API

GET /v1/kundencheck/{fnr}

Parameter

Aufruf

Antwort

Fehler

UID-Prüfung (VIES)

GET /v1/uid/{uid}

Parameter

Aufruf

Antwort

Fehler

Fehler, die jeder Aufruf haben kann

MCP für KI-Assistenten

GET `/v1/companies`

GET `/v1/companies/{fnr}`

GET `/v1/companies/{fnr}/gewerbe`

GET `/v1/companies/{fnr}/financials`

GET `/v1/companies/{fnr}/documents/{stichtag}`

GET `/v1/persons`

GET `/v1/persons/{key}`

GET `/v1/companies/{fnr}/persons`

GET `/v1/changes`

GET `/v1/watchlist/changes`

GET `/v1/kundencheck/{fnr}`

GET `/v1/uid/{uid}`