API Reference

Official data on German companies through a REST API: registry records, financials, people, and documents — straight from the commercial register, in real time when you need it.

Base URL

https://handelsregister.ai/api

Format

JSON

Auth

API Key

Rate Limits

60/min (5/min documents)

Quickstart

From zero to your first company profile in three steps.

1. 01

   Get your API key

   Sign up for free and copy your API key from the dashboard. New accounts start with free credits to try every feature.

   Open dashboard
2. 02

   Make your first request

   Fetch a company profile with two paid features — send your key in the x-api-key header:

   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

   Read the response

   Core company data is always included, and each requested feature appears as its own top-level key. The meta object shows exactly what was charged — features without data cost nothing:

   {
     "entity_id": "71e3213870c1f73ba060fb5b58f90a95",
     "name": "Bayerische Motoren Werke Aktiengesellschaft",
     "status": "ACTIVE",
     "legal_form": "AG",
     "registration": {"court": "München", "register_type": "HRB", "register_number": "42243"},
     "financial_kpi": [{"year": 2025, "revenue": 133453000000, "net_income": 7451000000, "...": "...",
       "_provenance": {"statement_type": "Konzernabschluss", "period_start": "2025-01-01", "period_end": "2025-12-31", "exempt_subsidiary": false, "parent_organization": null}}, "..."],
     "related_persons": {"current": ["..."], "past": ["..."]},
     "meta": {"request_credit_cost": 8, "credits_remaining": 992}
   }