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
]
}
}Felder und Quellen
| Feld | Bedeutung | Quelle |
|---|---|---|
company_id | Kanonische Firmenkennung, Eingabeschlüssel für alle Register- und Abschlussabfragen. | Handelsregister (SI-Daten) |
legal_name | Aktuell eingetragener Firmenname. | Handelsregister (SI-Daten) |
legal_form | Normalisierte Rechtsform wie gmbh, ag oder ug. | Handelsregister (SI-Daten) |
address | Eingetragene Anschrift des Unternehmenssitzes. | Handelsregister (SI-Daten) |
people | Aktuelle Vertreter aus den strukturierten Registerdaten. | Handelsregister (SI-Daten) |
owners | Gesellschafter mit Name, Nennbetrag und Anteil aus der Gesellschafterliste. | Gesellschafterliste |
reports | Jahresabschlüsse je Geschäftsjahr mit Bilanzsumme, Umsatzerlösen und weiteren Kennzahlen. | Bundesanzeiger |
url | Signierter Download-Link zum Registerdokument, als XML oder PDF, 15 Minuten gültig. | Registerdokument |
Was eine Abfrage kostet
| Abfrage | Credits | Einheit |
|---|---|---|
| Firma suchen | 10 | je Anfrage mit Treffer |
| Firmenprofil abrufen | 10 | je Firma |
| Gesellschafter abrufen | 10 | je Firma |
| Jahresabschlüsse, ein Geschäftsjahr | 20 | je Abfrage |
| Jahresabschlüsse, fünf Geschäftsjahre (Standard) | 60 | je Abfrage |
| Veröffentlichungen listen | 10 | je Firma |
| Veröffentlichung auslesen | 10 | je Dokument |
| Veröffentlichung per KI auslesen | 50 | je Dokument |
| Registerdokument laden | 10 | je Dokument |
| Firma überwachen (Monitor) | 50 | je 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.
Häufige Fragen
Dokumentation
Weitere Datenquellen und Anwendungsfälle
- Handelsregister APIFirmen im deutschen Handelsregister suchen und Registerdaten, Gesellschafter und Dokumente als JSON abrufen.
- MCP Server für B2B LeadsGeprüfte B2B Leadlisten direkt aus Claude, ChatGPT, Cursor und Claude Code, eingerichtet in drei Schritten.
- Neugründungen und RegisteränderungenFirmen im Handelsregister nach Rechtsform und Ort finden und Änderungen an bekannten Firmen per Webhook verfolgen.
- Google Maps LeadsFirmen aus Google Maps finden, Impressum und Entscheider lesen und geprüfte Mails als Leadliste bekommen.