API Reference

Přístup k rozsáhlým německým firemním datům prostřednictvím našeho RESTful API. Informace v reálném čase z oficiálních obchodních rejstříků.

Základní URL

https://handelsregister.ai/api

Formát

JSON

Autentizace

API klíč

Limity rychlosti

60/min (5/min dokumenty)

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}
   }