Häufige Fragen

Aus den amtlichen Registern und Veröffentlichungen: dem Handelsregister, dem Unternehmensregister mit den Jahresabschlüssen und den Insolvenzbekanntmachungen. Nachrichten und Website-Inhalte kommen aus dem Web. Mehr unter Datenverfügbarkeit.

Viele Angaben lesen wir maschinell aus den veröffentlichten Dokumenten und Bekanntmachungen. Wir setzen dafür die neueste Technik ein und investieren viel in die Qualität; einzelne Fehler sind trotzdem möglich.

Ein Firmenprofil kommt aus unserem Datenbestand. Mit Echtzeit fragt die API zusätzlich das Handelsregister live ab und liefert die aktuell eingetragenen Personen. Dokumente holt die API beim Abruf aus dem Register.

Wurde dasselbe Dokument kurz vorher schon abgerufen, kann es bis zu 24 Stunden alt sein.

Firmen müssen Jahresabschlüsse spätestens zwölf Monate nach dem Stichtag veröffentlichen, und viele nutzen die Frist voll aus. Der neueste Abschluss betrifft deshalb oft das vorletzte Geschäftsjahr.

Meist, weil die Firma ihn nicht veröffentlichen muss. Was öffentlich ist, hängt von Rechtsform und Größe ab: Eine kleine GmbH legt etwa keine GuV offen, also gibt es für sie meist keinen Umsatz. Leere Werte stehen als null oder [] in der Antwort.

Bei einem Namen, den mehrere Firmen tragen, kann die API eine davon liefern, nicht unbedingt die gemeinte, oder mit 404 antworten. Wenn es genau sein muss, frag mit Registergericht und Registernummer an, etwa „Ansbach HRB 6089“, oder mit der entity_id. Die Registernummer allein reicht nicht, denn dieselbe Nummer gibt es bei vielen Gerichten.

Nein. Ein Feature wird nur berechnet, wenn es Daten liefert. Den AI-Mode berechnen wir dagegen auch, wenn er keine Firma findet. Nur wenn die API die Anfrage mit 408 abbricht, entfällt er. Echtzeit kostet bei jedem gelungenen Live-Abruf, auch wenn er nichts Neues zeigt.

Nichts. Eine Anfrage, die mit einem Fehler endet, wird nicht berechnet; die einzige Ausnahme ist der Aufschlag für den AI-Mode. Bei Status 402 nennt meta.request_credit_cost, was die Anfrage höchstens gekostet hätte. Mehr unter Fehler.

Nein. Firmenprofile, Suche & Export, Dokumente und Signals nutzt du mit jedem Konto; du zahlst nur die Credits. Ein Credit-Abo schaltet zusätzliche Daten frei:

• Plus: das Personenprofil.
• Pro: die erweiterten Finanz-KPIs, das Feature Firmen-Netzwerk, Suchfilter nach Eigentum, Führung und Insolvenz sowie das Signals-Thema Insolvenzen.
• Max: alles aus Pro, dazu das Feature Tiefe Gesellschafter, die Tätigkeitsabschlüsse von Energieversorgern und das Signals-Thema Umwandlungen & M&A.

Alles zu Preisen und Plänen steht unter Abrechnung.

Ein neues Konto bekommt 150 Startcredits. Startcredits und Top-up Credits gelten ohne Credit-Abo 30 Tage. Solange ein Credit-Abo läuft, verfallen sie nicht.

Für Echtzeit, Personenprofile und Dokumente mindestens 120 Sekunden, denn diese Anfragen brauchen länger. Gelingt bei Echtzeit nur der Live-Abruf nicht, bekommst du die gespeicherten Daten ohne Aufschlag für Echtzeit. Dauert die Anfrage zu lange, endet sie mit 408, bei Dokumenten mit 504. Berechnet wird dann nichts. Versuch es später noch einmal.

Für Firmenprofile 60 Anfragen pro Minute und Konto, für Dokumente 5. Darüber antwortet die API mit Status 429 und nennt in Retry-After die Wartezeit. Alle Limits stehen unter Limits.

Ja, bei Firmenprofilen, Personenprofilen, der Suche und Dokumenten. Schick dazu einen eigenen Wert im Header Idempotency-Key mit. Wiederholst du die Anfrage mit demselben Schlüssel und denselben Parametern innerhalb von 24 Stunden, kostet sie nichts mehr.

Ja. Unter Konto › API-Schlüssel legst du weitere Schlüssel an, etwa einen pro Anwendung. Löschst du einen Schlüssel, ist er sofort ungültig. Alle Schlüssel teilen sich das Guthaben deines Kontos.