firmafind Österreich – Firmenbuch online kostenfrei durchsuchen

API Dokumentation

Vollständige Referenz für die FirmaFind API-Endpunkte

Erste Schritte

Authentifizierung und grundlegende Verwendung der API

Basis-URL

https://firmafind.at

Authentifizierung

Alle API-Anfragen erfordern einen API-Schlüssel im Authorization-Header:

x-api-key: IHR_API_SCHLÜSSEL

Beispiel-Anfrage

curl -X GET "https://firmafind.at/api/companies?name=example" \
  -H "x-api-key: IHR_API_SCHLÜSSEL"

Endpunkt-Übersicht

Alle verfügbaren API-Endpunkte auf einen Blick

GET/api/companiesFirmen suchen

GET/api/companies/:fnrFirmendetails abrufen

GET/api/documentsDokumente auflisten

GET/api/documents/:keyDokument herunterladen

API Endpunkte

GET/api/companies

Firmen suchen

Sucht nach Firmen im österreichischen Firmenbuch basierend auf dem Firmennamen. Gibt eine Liste aller übereinstimmenden Firmen mit Basisinformationen zurück.

Query-Parameter

Parameter	Typ	Erforderlich	Beschreibung
name	string	Ja	Suchbegriff für den Firmennamen (z.B. sons)

Beispiel-Anfrage

curl -X GET "https://firmafind.at/api/companies?name=u.%20sons" \
  -H "x-api-key IHR_API_SCHLÜSSEL"

Response-Felder

Feld	Typ	Beschreibung
fnr	string	Firmenbuchnummer (eindeutige Kennung)
name	string	Offizieller Firmenname
sitz	string	Firmensitz (Stadt)
rechtsform	string	Rechtsform der Firma (z.B. GmbH, e.U.)
status	string	Status der Firma (aktiv oder gelöscht)
gericht	string	Zuständiges Handelsgericht

Beispiel-Antwort

{
  "success": true,
  "data": [
    {
      "fnr": "579180k",
      "name": "Chladek & Sons GmbH",
      "sitz": "Wien",
      "rechtsform": "Gesellschaft mit beschränkter Haftung",
      "status": "aktiv",
      "gericht": "Handelsgericht Wien"
    },
    {
      "fnr": "502231a",
      "name": "LOS & Sons GmbH",
      "sitz": "Innsbruck",
      "rechtsform": "Gesellschaft mit beschränkter Haftung",
      "status": "aktiv",
      "gericht": "Landesgericht Innsbruck"
    }
  ],
  "meta": {
    "count": 8,
    "cost": 1,
    "remainingBalance": 19991
  }
}

Kosten

1 Credit pro Anfrage

GET/api/companies/:fnr

Firmendetails abrufen

Ruft detaillierte Firmenbuchinformationen zu einer bestimmten Firma ab, inklusive Adresse, Geschäftsführung und Firmenbuch-Transaktionen.

URL-Parameter

Parameter	Typ	Beschreibung
fnr	string	Firmenbuchnummer (z.B. 579180k)

Beispiel-Anfrage

curl -X GET "https://firmafind.at/api/companies/579180k" \
  -H "x-api-key: IHR_API_SCHLÜSSEL"

Response-Felder

Feld	Typ	Beschreibung
fnr	string	Firmenbuchnummer
euid	string	Europäische Unternehmenskennung
companyName	string	Offizieller Firmenname
isActive	boolean	Status ob Firma aktiv ist
legalForm	string	Vollständige Rechtsformbezeichnung
address	object	Adressdaten (Straße, PLZ, Stadt, Sitz)
management	array	Liste der Geschäftsführer mit Rollen und Vertretungsbefugnis
transactions	array	Firmenbuch-Transaktionshistorie

Beispiel-Antwort

{
  "success": true,
  "data": {
    "fnr": "579180 k",
    "euid": "ATBRA.579180-000",
    "companyName": "Chladek & Sons GmbH",
    "isActive": true,
    "legalForm": "Gesellschaft mit beschränkter Haftung",
    "address": {
      "street": "Czerninplatz",
      "houseNumber": 4,
      "postalCode": 1020,
      "city": "Wien",
      "seat": "Wien"
    },
    "management": [
      {
        "name": "Dipl.-Ing. Josef Gottfried Chladek",
        "role": "GESCHÄFTSFÜHRER/IN (handelsrechtlich)",
        "position": "vertritt seit 13.04.2022 selbständig",
        "since": "13.04.2022"
      }
    ],
    "transactions": [
      {
        "id": "1",
        "description": "Antrag auf Neueintragung einer Firma eingelangt am 11.04.2022",
        "date": "2022-04-13",
        "type": "Handelsgericht Wien"
      }
    ]
  },
  "meta": {
    "cost": 1,
    "remainingBalance": 19976
  }
}

Kosten

1 Credit pro Anfrage

GET/api/documents

Dokumente auflisten

Ruft eine Liste aller verfügbaren Dokumente (Jahresabschlüsse, Bilanzen) für eine bestimmte Firma ab. Dokumente sind sowohl als PDF als auch als XML verfügbar.

Query-Parameter

Parameter	Typ	Erforderlich	Beschreibung
fnr	string	Ja	Firmenbuchnummer der Firma

Beispiel-Anfrage

curl -X GET "https://firmafind.at/api/documents?fnr=579180k" \
  -H "x-api-key: IHR_API_SCHLÜSSEL"

Response-Felder

Feld	Typ	Beschreibung
key	string	Eindeutiger Dokumentenschlüssel für Download
fnr	string	Firmenbuchnummer
az	string	Aktenzeichen
dokumentart	object	Dokumenttyp mit Code und Beschreibung
contentType	string	MIME-Type (application/pdf oder application/xml)
dateiendung	string	Dateiendung (pdf oder xml)
groesse	number	Dateigröße in Bytes
stichtag	string	Bilanzstichtag (YYYY-MM-DD)
eingereicht	string	Einreichungsdatum beim Firmenbuch

Beispiel-Antwort

{
  "success": true,
  "data": [
    {
      "key": "579180_0070752319041_000___000_30_29893872_PDF",
      "fnr": "579180 k",
      "az": "007 075 Fr 19041/23 b",
      "dokumentart": {
        "code": 48,
        "text": "Jahresabschluss"
      },
      "contentType": "application/pdf",
      "dateiendung": "pdf",
      "groesse": 118285,
      "stichtag": "2022-12-31",
      "gkl": "W",
      "vnr": 2,
      "eingereicht": "2023-05-09"
    },
    {
      "key": "579180_0070752521339_000___000_30_35697663_XML",
      "fnr": "579180 k",
      "az": "007 075 Fr 21339/25 z",
      "dokumentart": {
        "code": 48,
        "text": "Jahresabschluss"
      },
      "contentType": "application/xml",
      "dateiendung": "xml",
      "groesse": 4226,
      "stichtag": "2024-12-31",
      "gkl": "W",
      "vnr": 4,
      "eingereicht": "2025-06-04"
    }
  ],
  "meta": {
    "count": 6,
    "filters": {
      "fnr": "579180k",
      "limit": null
    },
    "cost": 1,
    "remainingBalance": 19980
  }
}

Kosten

1 Credit pro Anfrage

GET/api/documents/:key

Dokument herunterladen

Lädt ein spezifisches Dokument herunter. Das Dokument wird Base64-kodiert zurückgegeben und kann direkt dekodiert werden. Enthält auch Metadaten zum Dokument.

URL-Parameter

Parameter	Typ	Beschreibung
key	string	Eindeutiger Dokumentenschlüssel aus der Dokumentenliste

Beispiel-Anfrage

curl -X GET "https://firmafind.at/api/documents/579180_0070752521339_000___000_30_35697663_XML" \
  -H "x-api-key: IHR_API_SCHLÜSSEL"

Response-Felder

Feld	Typ	Beschreibung
metadaten.key	string	Dokumentenschlüssel
metadaten.urkid	number	Urkundenidentifikationsnummer
metadaten.dokumentart	object	Code und Bezeichnung des Dokumenttyps
metadaten.stichtag	string	Bilanzstichtag
metadaten.oeffentlich	boolean	Öffentlich einsehbar
dokument.contentType	string	MIME-Type des Dokuments
dokument.content	string	Base64-kodierter Dokumenteninhalt

Beispiel-Antwort

{
  "success": true,
  "data": {
    "metadaten": {
      "key": "579180_0070752521339_000___000_30_35697663_XML",
      "urkid": 35697663,
      "fnr": "579180 k",
      "az": "007 075 Fr 21339/25 z",
      "dokumentart": {
        "code": 48,
        "text": "Jahresabschluss"
      },
      "dokumentendatum": "2024-12-31",
      "stichtag": "2024-12-31",
      "gkl": "W",
      "vnr": 4,
      "von": "2025-06-05",
      "oeffentlich": true
    },
    "dokument": {
      "contentType": "application/xml",
      "dateiendung": "xml",
      "content": "<base64 encoded document>"
    }
  },
  "meta": {
    "cost": 1,
    "remainingBalance": 19979
  }
}

💡 Hinweis zur Base64-Dekodierung

Der content-Wert ist Base64-kodiert. Um das Dokument zu verwenden, muss es dekodiert werden:

// JavaScript Beispiel
const content = response.data.dokument.content;
const decoded = atob(content); // Base64 dekodieren
const blob = new Blob([decoded], { 
  type: response.data.dokument.contentType 
});

// Als Download anbieten
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = `dokument.${response.data.dokument.dateiendung}`;
a.click();

Kosten

1 Credit pro Anfrage

Fehlerbehandlung

Standardisierte Fehlerantworten der API

Status Code	Beschreibung	Beispiel
400	Ungültige Anfrage - Pflichtparameter fehlen	{ "error": "Search parameter 'name' is required" }
401	Ungültiger oder fehlender API-Schlüssel	{ "error": "Invalid or expired API key" }
402	Unzureichende Credits	{ "error": "Insufficient credits", "currentBalance": 0 }
404	Ressource nicht gefunden	{ "error": "Document not found" }
500	Interner Serverfehler	{ "error": "Internal Server Error" }

Antwort-Format

Struktur der API-Antworten

Erfolgreiche Antwort

Alle erfolgreichen Antworten enthalten ein success: true Flag, die angefragten Daten im data-Objekt und Metainformationen im meta-Objekt:

{
  "success": true,
  "data": { /* Ihre Daten */ },
  "meta": {
    "count": 1,              // Anzahl der Ergebnisse
    "cost": 1,               // Verbrauchte Credits
    "remainingBalance": 999  // Verbleibende Credits
  }
}

Credit-System

Jeder API-Aufruf kostet 1 Credit. Das meta-Objekt zeigt die verbrauchten Credits und den aktuellen Kontostand.

Datenintegrität

Alle Daten stammen direkt aus dem österreichischen Firmenbuch und werden in Echtzeit abgerufen.