Firmenbuch API für österreichische Firmendaten

Welche Daten die Firmenakte-API liefert

Die Firmenakte-API deckt sieben Bereiche ab: Unternehmen, Personen, Verflechtungen, Gewerbe, Edikte, Dokumente und Änderungen, dazu die Kataloge zur Auflösung von Codes. Das Firmenbuch ist das öffentliche Register aller eingetragenen Rechtsträger Österreichs; jeder Rechtsträger trägt eine Firmenbuchnummer (FN), etwa 34853f. Alle Endpoints antworten unter der Base-URL https://api.firmenakte.at mit JSON, Dokumente zusätzlich als PDF oder XML.

Ein Firmenprofil enthält unter anderem Firmenbuchnummer, Firmenwortlaut, Rechtsform, zuständiges Firmenbuchgericht, Sitz und Zustelladresse, ÖNACE-Code (die österreichische Systematik der Wirtschaftstätigkeiten), Aktiv-Status, eingetragene Funktionen mit Funktionscode, Gewerbeberechtigungen, offene Edikte, verfügbare Jahresabschlüsse, Mitarbeiteranzahl und die veröffentlichten Bilanz- und GuV-Kennzahlen.

In drei Schritten zum ersten API-Call

Der erste erfolgreiche Request braucht drei Schritte: API-Key im Dashboard erstellen, Key im Header x-api-key setzen, Request absetzen. Es gibt kein OAuth, keinen Token-Tausch und keine Freischaltung durch den Vertrieb.

# Aktive GmbHs (Rechtsform-Code GES) in Wien, sortiert nach Umsatzerlösen
curl -G https://api.firmenakte.at/api/v1/businesses \
  -H "x-api-key: $FIRMENAKTE_KEY" \
  --data-urlencode "city=Wien" \
  --data-urlencode "legalFormCode=GES" \
  --data-urlencode "active=true" \
  --data-urlencode "orderBy=guv.Umsatzerloese" \
  --data-urlencode "orderByDescending=true" \
  --data-urlencode "pageSize=50"

Unternehmen nach Kennzahlen filtern: der Bilanzdaten-Screener

Der Endpoint GET /api/v1/businesses ist ein Screener: Er filtert österreichische Unternehmen über Range-Filter auf 47 Kennzahlen – 46 Bilanz- und GuV-Werte plus die Mitarbeiteranzahl. Jede Kennzahl akzeptiert die Suffixe _gte und _lte und lässt sich mit Ort (city), PLZ (zipCode), Firmenbuchgericht (courtCode), Rechtsform (legalFormCode), ÖNACE-Branchencode (oenaceCode), Gewerbeberechtigung (gisaLicenseKey) und Aktiv-Status (active) kombinieren. Sortiert wird mit orderBy und orderByDescending nach jeder Kennzahl, ausgeliefert werden bis zu 1.000 Treffer pro Seite (pageSize); countOnly=true liefert nur die Treffermenge, was Mengenabfragen deutlich beschleunigt. Diese Kombination unterscheidet die Firmenakte-API von einer reinen Registerauskunft, die nur Einzelabfragen je Firmenbuchnummer beantwortet.

GET /api/v1/businesses
    ?city=Wien
    &legalFormCode=GES
    &active=true
    &guv.Umsatzerloese_gte=10000000
    &employees_gte=50
    &orderBy=guv.Jahresueberschuss
    &orderByDescending=true
    &pageSize=100

Die zwölf am häufigsten verwendeten filterbaren Kennzahlen

Die vollständige Liste aller 47 Kennzahlen samt Datentypen steht in der OpenAPI-Spezifikation der Firmenakte-API.

Firmenbuch-Änderungen überwachen statt abfragen

Für Monitoring stellt die Firmenakte-API Change-Feeds bereit: Statt Bestände periodisch neu abzufragen, holt ein Client nur die Änderungen seit dem letzten Stand. Der Cursor läuft entweder über since (Zeitstempel) oder sinceId. Es gibt getrennte Feeds für Firmenbuch (/businesses/changes), Gewerbe (/trades/changes), Edikte (/edikte/changes) und Dokumente (/documents/changes). /globalchanges/aggregated fasst Business-, Dokument-, Edikt- und Global-Changes in einer Antwort zusammen und liefert über maxResultsPerType bis zu 2.000 Einträge pro Typ.

import { createApiClient } from "@firmenakte/api-client";

const client = createApiClient({ apiKey: process.env.FIRMENAKTE_KEY! });

let since = await ladeLetztenStand(); // ISO-Zeitstempel aus der eigenen Datenbank

setInterval(async () => {
  const abfragezeit = new Date().toISOString();

  // Business-, Dokument-, Edikt- und Global-Changes in einem Response
  const { data } = await client.v1GlobalchangesAggregatedList({
    since,
    maxResultsPerType: 2000,
  });

  for (const change of data.businessChanges ?? []) await verarbeiteFirmenaenderung(change);
  for (const edikt of data.ediktChanges ?? []) await pruefeInsolvenz(edikt);

  since = abfragezeit;
  await speichereStand(since);
}, 15 * 60 * 1000);

Typische Anwendungsfälle

Datenquellen und Aktualität

Die Firmenakte-API führt vier amtliche Quellen zusammen. Alle vier sind öffentliche Register: Firmenbuch und Ediktsdatei unterliegen dem Publizitätsprinzip, das GISA und die Liste der Scheinunternehmen werden von den zuständigen Behörden veröffentlicht. Die veröffentlichten Jahresabschlüsse kommen als Dokumente aus dem Firmenbuch und werden zu Kennzahlen aufbereitet. Die Firmenakte-API speichert diese Daten, verknüpft sie über die Firmenbuchnummer und stellt sie strukturiert bereit; sie ist keine amtliche Auskunft und ersetzt im Rechtsverkehr keinen beglaubigten Firmenbuchauszug.

Hintergründe zu den Registern: Firmenbuch erklärt, Gewerbe und GISA und Rechtsformen in Österreich.

Firmendaten ohne Code automatisieren: n8n, Make und Zapier

Die Firmenakte-API lässt sich in jedem Automatisierungswerkzeug nutzen, das HTTP-Requests senden kann – ohne eigene Anwendung. In n8n, Make und Zapier genügt ein generischer HTTP-Request-Schritt mit der Ziel-URL und dem Header x-api-key. Typische Workflows: eingehende Leads gegen das Firmenbuch prüfen, neue Kunden beim Anlegen im CRM mit Rechtsform und Aktiv-Status anreichern oder täglich den Edikt-Feed abfragen und bei einem Treffer eine Nachricht in Slack oder Teams senden.

Methode:  GET
URL:      https://api.firmenakte.at/api/v1/businesses
Header:   x-api-key: DEIN_API_KEY
          Accept: application/json
Query:    city=Wien
          legalFormCode=GES
          active=true
          pageSize=50

MCP-Server für KI-Agenten

Der MCP-Server der Firmenakte unter https://mcp.firmenakte.at/mcp stellt die API-Endpoints als Werkzeuge für KI-Agenten bereit. MCP steht für Model Context Protocol, einen offenen Standard, über den Sprachmodelle externe Werkzeuge aufrufen. Statt HTTP-Requests selbst zu formulieren, ruft ein Agent in Claude Desktop, Cursor oder n8n die Firmenakte-Werkzeuge direkt auf und bekommt strukturierte Registerdaten zurück – etwa für die Frage, welche aktiven Gesellschaften eine bestimmte Person vertritt. Die Anmeldung läuft über OAuth mit dem eigenen Firmenakte-Konto: Der Client öffnet beim Verbinden den Login, ein API-Key muss nicht hinterlegt werden – der Server verwendet serverseitig den Key des angemeldeten Kontos.

{
  "mcpServers": {
    "firmenakte": {
      "url": "https://mcp.firmenakte.at/mcp"
    }
  }
}

Endpoint, Anmeldung, Werkzeuge und ihre eine Einschränkung stehen auf der Seite zum MCP-Server der Firmenakte.

Technische Details in der Dokumentation

Diese Seite beschreibt, was die Firmenakte-API kann. Alles, was beim Bauen zählt – Authentifizierung, Statuscodes, Paginierung, Rate-Limits und die vollständige Feldreferenz je Endpoint – steht in der Dokumentation und in der OpenAPI-Spezifikation. Welcher Client für welche Sprache existiert, sagt die Seite zu Libraries und SDKs.

Preise und Limits

Die Firmenakte-API rechnet über ein monatliches Requestkontingent ab, nicht pro Einzelabfrage. Suchen, Filtern und Beobachten im Dashboard sind in jedem Plan unbegrenzt; bezahlt wird nur das API-Anfragevolumen. Alle Endpoints stehen in jedem Plan zur Verfügung.

Zusätzlich gilt ein technisches Rate-Limit von 1.000 Requests pro Minute je Key – in jedem Plan gleich. Details und Zahlungsarten auf der Preisübersicht von Firmenakte.

API-Abfrage statt manueller Recherche

Eine manuelle Firmenbuchabfrage beantwortet eine Frage zu einem Unternehmen zu einem Zeitpunkt. Die Firmenakte-API beantwortet dieselbe Frage für beliebig viele Unternehmen, wiederholbar und automatisiert. Der Unterschied wird ab der zweiten Prüfung pro Woche relevant.

Häufige Fragen zur Firmenbuch-API