API Referenz

Amtliche Daten zu deutschen Unternehmen über eine REST-API: Stammdaten, Finanzen, Personen und Dokumente — direkt aus dem Handelsregister, auf Wunsch in Echtzeit.

Basis-URL

https://handelsregister.ai/api

Format

JSON

Authentifizierung

API-Key

Rate Limits

60/min (5/min Dokumente)

Schnellstart

In drei Schritten zum ersten Unternehmensprofil.

1. 01

   API-Key holen

   Registriere Dich kostenlos und kopiere Deinen API-Key aus dem Dashboard. Neue Konten starten mit Gratis-Credits zum Ausprobieren aller Features.

   Dashboard öffnen
2. 02

   Erste Anfrage senden

   Ruf ein Unternehmensprofil mit zwei kostenpflichtigen Features ab — den API-Key schickst Du im x-api-key-Header mit:

   curl 'https://handelsregister.ai/api/v1/fetch-organization?q=BMW%20AG&feature=financial_kpi&feature=related_persons' \
        -H 'x-api-key: YOUR_API_KEY'

3. 03

   Antwort verstehen

   Die Kerndaten des Unternehmens sind immer enthalten, jedes angeforderte Feature erscheint als eigener Top-Level-Schlüssel. Das meta-Objekt zeigt genau, was berechnet wurde — Features ohne Daten kosten nichts:

   {
     "entity_id": "cc78cf0b230aeae35c6df7ba31989bb9",
     "name": "Bayerische Motoren Werke Aktiengesellschaft",
     "status": "ACTIVE",
     "legal_form": "AG",
     "registration": {"court": "München", "register_type": "HRB", "register_number": "42243"},
     "financial_kpi": [{"year": 2021, "revenue": 111239000000, "net_income": 12382000000}, "..."],
     "related_persons": {"current": ["..."], "past": ["..."]},
     "meta": {"request_credit_cost": 8, "credits_remaining": 992}
   }