Firmendaten API: deutsche Unternehmensdaten aus Registern und Bundesanzeiger abrufen

Die Firmendaten API von Skael liefert Stammdaten deutscher Unternehmen aus amtlichen Quellen: Handelsregisterdaten, Gesellschafter, Vertreter und Jahresabschlüsse aus dem Bundesanzeiger. Jede Abfrage ist ein POST mit deinem API-Schlüssel, synchron, asynchron mit Polling oder per Webhook an deine callback_url. Melde dich gratis an und starte mit dem API-Leitfaden in der Doku.

Stand:

Beispiel: Abschlüsse einer GmbH abrufen

Mit der company_id aus einer Registerabfrage rufst du die letzten Jahresabschlüsse einer Firma aus dem Bundesanzeiger ab. Die Antwort enthält die Kennzahlen je Geschäftsjahr.

Anfrage

POST /api/enrichments/get_company_financials
Authorization: Bearer eak_...
Content-Type: application/json

{
  "company_id": "DE-HRB-F1103-267645"
}

Antwort

{
  "company_id": "DE-HRB-F1103-267645",
  "reports": [
    {
      "fiscal_year": 2024,
      "publication_id": "regpub_v1_…",
      "source": "bundesanzeiger",
      "type": "jahresabschluss",
      "published_at": "2025-04-15",
      "fiscal_period": {
        "from": "2024-01-01",
        "to": "2024-12-31"
      },
      "extraction_method": "parser",
      "financials": {
        "umsatzerloese": 2024000000,
        "bilanzsumme": 4048000000,
        "real_estate": {
          "has_real_estate": true,
          "grundstuecke_und_bauten": 202400000
        }
      }
    }
  ],
  "merged": {
    "umsatzerloese": 2024000000,
    "bilanzsumme": 4048000000,
    "real_estate": {
      "has_real_estate": true,
      "grundstuecke_und_bauten": 202400000
    }
  },
  "_registry_meta": {
    "cache_hit_ratio": 1,
    "total_scrape_duration_ms": 0,
    "years_requested": [
      2024,
      2023,
      2022,
      2021,
      2020
    ],
    "years_returned": [
      2024,
      2023,
      2022,
      2021,
      2020
    ]
  }
}
Endpunkt in der Doku

Felder und Quellen

FeldBedeutungQuelle
company_idKanonische Firmenkennung, Eingabeschlüssel für alle Register- und Abschlussabfragen.Handelsregister (SI-Daten)
legal_nameAktuell eingetragener Firmenname.Handelsregister (SI-Daten)
legal_formNormalisierte Rechtsform wie gmbh, ag oder ug.Handelsregister (SI-Daten)
addressEingetragene Anschrift des Unternehmenssitzes.Handelsregister (SI-Daten)
peopleAktuelle Vertreter aus den strukturierten Registerdaten.Handelsregister (SI-Daten)
ownersGesellschafter mit Name, Nennbetrag und Anteil aus der Gesellschafterliste.Gesellschafterliste
reportsJahresabschlüsse je Geschäftsjahr mit Bilanzsumme, Umsatzerlösen und weiteren Kennzahlen.Bundesanzeiger
urlSignierter Download-Link zum Registerdokument, als XML oder PDF, 15 Minuten gültig.Registerdokument

Was eine Abfrage kostet

AbfrageCreditsEinheit
Firma suchen10je Anfrage mit Treffer
Firmenprofil abrufen10je Firma
Gesellschafter abrufen10je Firma
Jahresabschlüsse, ein Geschäftsjahr20je Abfrage
Jahresabschlüsse, fünf Geschäftsjahre (Standard)60je Abfrage
Veröffentlichungen listen10je Firma
Veröffentlichung auslesen10je Dokument
Veröffentlichung per KI auslesen50je Dokument
Registerdokument laden10je Dokument
Firma überwachen (Monitor)50je Monitor

Alle Tarife und Abrechnungsregeln stehen auf der Preisseite.

Was die Firmendaten API liefert

Stammdaten deutscher Unternehmen liegen auf mehrere amtliche Quellen verteilt: das Handelsregister für Firma, Rechtsform, Sitz, Kapital und Vertretung, die Gesellschafterliste für Eigentümer und der Bundesanzeiger für Jahresabschlüsse. Skael liest alle drei und gibt sie als JSON zurück.

Aus einer Abfrage bekommst du die kanonische company_id, den eingetragenen Firmennamen, Rechtsform, Registerangaben, Anschrift, Kapital, aktuelle Vertreter und den Status. Die Abschlüsse liefern je Geschäftsjahr Kennzahlen wie Umsatzerlöse und Bilanzsumme, zusammengeführt im Feld merged.

Registerdokumente wie den aktuellen Ausdruck oder die Gesellschafterliste lädst du über einen signierten Link herunter. Wer laufend informiert bleiben will, legt einen Monitor auf eine Firma und bekommt Änderungen am Registerbestand als signierten Webhook.

So läuft eine Abfrage

Jede Abfrage ist ein POST an /api/enrichments/{type} mit deinem API-Schlüssel im Authorization-Header. Synchron bekommst du die Antwort direkt, asynchron holst du sie per Polling oder lässt dir einen Webhook an deine callback_url schicken. Für mehrere Firmen gibt es den Batch-Endpunkt.

Der Einstieg ist search_company oder autocomplete_company: du findest die company_id, mit der get_company das Profil liefert. Firmen, die in den letzten 30 Tagen abgerufen wurden, kommen aus dem Bestand und antworten in unter einer Sekunde, alle anderen live in 5 bis 30 Sekunden.

Abschlüsse rufst du mit get_company_financials ab. Ohne Angabe kommen die letzten fünf Geschäftsjahre, mit fiscal_years wählst du bis zu zehn bestimmte Jahre. list_company_publications zeigt zuerst, welche Veröffentlichungen im Bundesanzeiger vorliegen, get_publication liest eine einzelne davon aus.

Grenzen in v1

Die Firmensuche in v1 läuft im Registerbestand von Skael, nicht live auf handelsregister.de. Einen Filter nach Gründungs- oder Eintragungsdatum gibt es nicht. Abschlüsse gibt es nur, soweit sie im Bundesanzeiger veröffentlicht sind. Findet Skael keine, kostet die Abfrage 0 Credits.

Die Register-Endpunkte laufen als Pilot und werden je Organisation freigeschaltet. Ohne Freischaltung antwortet die API mit 403.

FAQ

Häufige Fragen

Dokumentation

Weitere Datenquellen und Anwendungsfälle