fetch-organization
Endpoints
GET

/v1/fetch-organization

5-21 credits • 60/min

Haal uitgebreide informatie op over een Duits bedrijf inclusief juridische status, financiële gegevens, management en meer.

Parameters

Naam Type Vereist Beschrijving
api_key string Voorwaardelijk* Uw API-sleutel. Vereist als u geen x-api-key header of Bearer token gebruikt
q string VEREIST Bedrijfsnaam, registratienummer of zoekquery
feature string optioneel Extra gegevensfunctie om op te nemen. Kan meerdere keren worden gespecificeerd (zie functietabel hieronder)
ai_search string optioneel AI-zoeken inschakelen. Waarden: on-default of de parameter volledig weglaten
realtime_mode string optioneel Aktiviert den Echtzeitmodus für Live-Daten direkt aus dem Handelsregister (+10 Credits). Einziger gültiger Wert: handelsregister-default — zum Deaktivieren den Parameter einfach weglassen.

Beschikbare Functies

financial_kpi 1 credit
balance_sheet_accounts 3 credits
profit_and_loss_account 3 credits
related_persons 2 credits
publications 1 credit
news 10 credits
insolvency_publications 5 credits
annual_financial_statements 5 credits
annual_financial_statements__html 5 Credits
shareholders Beta
5 credits
ubos Beta
10 Credits
shareholdings Beta
5 Credits
mergers_and_acquisitions Beta
20 Credits
network Beta Pro / Max
25 Credits
website_content AI
0 Credits
So funktioniert die Abrechnung
  • Jede Anfrage kostet 5 Credits Grundpreis; jedes angeforderte Feature kommt mit seinem Preis aus der Tabelle unten hinzu.
  • Features werden nur berechnet, wenn sie tatsächlich Daten liefern. Ein Feature ohne Ergebnis — etwa Insolvenzbekanntmachungen bei einem Unternehmen ohne Verfahren — kostet nichts. Das Feld request_credit_cost im meta-Objekt zeigt immer, was wirklich berechnet wurde.
  • Der AI-Modus (ai_search=on-default) kostet 20 Credits zusätzlich. Der Aufschlag fällt auch an, wenn die Anfrage selbst fehlschlägt — die AI-Verarbeitung läuft in dem Fall trotzdem.
  • Der Echtzeitmodus (realtime_mode=handelsregister-default) kostet 10 Credits zusätzlich und wird nur berechnet, wenn der Live-Abruf aus dem Register gelingt. Er ist nicht mit den Features related_persons und publications kombinierbar.

Voorbeeldverzoek

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

Voorbeeldrespons

{
  "entity_id": "add84642a957b08a3f252c69c9d063de",
  "name": "Polyden-Folienfabrik GmbH",
  "status": "TERMINATED",
  "legal_form": "GmbH",
  "purpose": "Herstellung von Folien...",
  "registration_date": "1978-02-23T00:00:00",
  "address": {
    "house_number": "38",
    "street": "Ansbacher Straße",
    "postal_code": "91560",
    "city": "Heilsbronn",
    "coordinates": {
      "latitude": 49.33438,
      "longitude": 10.78262
    }
  },
  "registration": {
    "court": "Ansbach",
    "register_type": "HRB",
    "register_number": "405"
  },
  "contact_data": {
    "website": "https://www.polyden.de",
    "phone_number": "+49 9872 808 0"
  },
  "representation_scheme": {
    "current": ["Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. ..."],
    "history": [
      {
        "value": ["Ist nur ein Geschäftsführer bestellt, ..."],
        "effective_from": "1995-11-10",
        "effective_to": null
      }
    ]
  },
  "capital": {
    "current": {"amount": 3297000.0, "currency": "EUR", "kind": "GRUNDKAPITAL"},
    "history": [
      {
        "value": {"amount": 3132000.0, "currency": "EUR", "kind": "GRUNDKAPITAL"},
        "effective_from": "2017-01-17",
        "effective_to": "2021-06-01"
      },
      {
        "value": {
          "amount": 3297000.0,
          "currency": "EUR",
          "kind": "GRUNDKAPITAL",
          "change_amount": {"amount": 165000.0, "currency": "EUR"}
        },
        "effective_from": "2021-06-01",
        "effective_to": null
      }
    ]
  },
  "financial_kpi": [
    {
      "year": 2022,
      "revenue": 41855558.25,
      "net_income": -19668989.99,
      "employees": 208
    }
  ],
  "related_persons": {
    "current": [
      {
        "name": "Knut Neumann",
        "role": {
          "en": {"long": "Managing Director"},
          "de": {"long": "Geschäftsführer"}
        },
        "start_date": "2019-06-03",
        "role_representation_scheme": {
          "current": ["einzelvertretungsberechtigt; mit der Befugnis, ..."],
          "history": ["..."]
        },
        "organization_representation_scheme": {"...": "..."}
      }
    ]
  },
  "publications": [...],
  "news": [
    {
      "title": "Company News Title",
      "source": "News Source",
      "publication_date": "2023-08-08"
    }
  ],
  "meta": {
    "request_credit_cost": 29,
    "credits_remaining": 73841334
  }
}

Details van Responsstructuur

Kernbedrijfsgegevens

Altijd inbegrepen: entity_id, name, status, legal_form, address, registration, contact_data, purpose, keywords, products_and_services, representation_scheme, capital

capital — Kapital und Kapitalhistorie

Eingetragenes Kapital als { current, history }. current ist ein Geldobjekt mit amount, currency und kind (STAMMKAPITAL, GRUNDKAPITAL, HAFTSUMME, GENEHMIGTES_KAPITAL, BEDINGTES_KAPITAL, VARIABLES_KAPITAL — die Liste ist offen). history enthält jede erfasste Fassung mit effective_from und effective_to (null = weiterhin gültig). Ein History-Eintrag kann change_amount tragen, also den in der Registereintragung genannten Betrag: dieser ist vorzeichenlos und entspricht nicht immer der Differenz zweier aufeinanderfolgender Beträge. Erhöhungen und Herabsetzungen sollten daher aus den Beträgen selbst abgeleitet werden. Rechtsträger ohne eingetragenes Kapital, etwa Personengesellschaften, liefern {"current": null, "history": []}. Im Grundpreis von 5 Credits enthalten — kein feature-Parameter nötig.

financial_kpi

Array van jaarlijkse financiële indicatoren (omzet, netto_inkomen, werknemers, enz.) over meerdere jaren

balance_sheet_accounts

Hiërarchische balansgegevens met uitsplitsing van activa en passiva per jaar

profit_and_loss_account

Gedetailleerde winst- en verliesrekeningen met uitsplitsing van omzet, uitgaven en winst per jaar

related_persons

Huidige en vroegere directeuren/functionarissen met rollen, namen en ambtstermijnen

publications

Officiële handelsregisterpublicaties en aankondigingen

news

Array van nieuwsartikelen met titel, bron, publicatiedatum en URL

insolvency_publications

Insolventiegerecht publicaties met data, zaak-ID's en gebeurtenisdetails

annual_financial_statements

Volledige jaarverslagen in markdown-formaat met metadata

annual_financial_statements__html

Vollständige Jahresabschlüsse als HTML, inklusive Metadaten.

shareholders Beta

Gesellschafterliste mit Anteilen und Rollen, inklusive historischer Listen (history). Berechnet nur, wenn die aktuelle Liste mindestens einen Eintrag enthält.

ubos Beta

Wirtschaftlich Berechtigte (UBOs) mit Beteiligungsquoten — aufgelöste und nicht aufgelöste Eigentümer plus Abdeckungsgrad.

shareholdings Beta

Beteiligungen dieses Unternehmens an anderen Gesellschaften mit Anteil, Einlage und Stichtag.

mergers_and_acquisitions Beta

M&A-Vorgänge (Verschmelzungen, Spaltungen, Unternehmensverträge) mit Gegenparteien, Rollen, Registerbezügen, Kontrollverhältnissen und Zusammenfassung.

network Beta Pro / Max

Das Beziehungsnetzwerk eines Unternehmens: Verbindungen zu verbundenen Unternehmen und Personen als Graph. Nur mit einem Pro- oder Max-Abo verfügbar; ohne Netzwerkdaten werden keine Credits berechnet.

website_content

Die Unternehmens-Website als strukturiertes Markdown, optimiert für LLMs (nur im AI-Modus, 0 Credits).

financial_kpi: Kennzahlen nach Plan

Welche Kennzahlen pro Geschäftsjahr enthalten sind, hängt von Ihrem Plan ab: Jeder Plan erhält die Basiskennzahlen. Mit Pro und Max liefert die Antwort zusätzlich erweiterte Kennzahlen aus Bilanz und Gewinn- und Verlustrechnung — zum unveränderten Preis von 1 Credit.

In allen Plänen enthalten

year employees active_total net_income revenue material_expenses personnel_expenses

Zusätzliche Kennzahlen Pro / Max

Unternehmensprofil

company_size_by_employees company_size_by_assets company_size_by_revenue revenue_per_employee net_income_per_employee

Gewinn- und Verlustrechnung

other_operating_income material_expenses_goods material_expenses_services wages_salaries social_expenses pension_costs depreciation_amortization depreciation_amortization_operating write_downs_financial_assets_and_securities other_operating_expenses selling_expenses admin_expenses sga opex_core gross_profit ebitda ebit ebt income_taxes other_taxes income_after_taxes interest_income interest_expense finance_income finance_income_from_affiliates

Bilanz

assets_total fixed_assets_total current_assets_total inventory_total receivables_total trade_receivables intragroup_receivables securities_current_total cash_and_equivalents ppe_total land_and_buildings intangible_assets goodwill long_term_financial_assets prepaid_expenses equity_total capital_reserves revenue_reserves profit_loss_carried_forward tangible_equity liabilities_total provisions_total pension_provisions other_provisions trade_payables intragroup_payables liabilities_to_affiliated_companies other_liabilities deferred_income bank_debt bonds

Working Capital & Verschuldung

operating_working_capital net_working_capital_strict net_working_capital_approx interest_bearing_debt_strict interest_bearing_debt_broad net_debt_narrow net_debt_broad

Kennzahlen

equity_ratio tangible_equity_ratio debt_to_equity debt_to_assets cash_to_assets cash_to_liabilities receivables_to_assets inventory_to_assets ppe_to_assets intangible_to_assets goodwill_to_assets intangible_to_equity gross_margin ebitda_margin ebit_margin net_margin material_intensity personnel_intensity sga_ratio opex_ratio interest_coverage effective_tax_rate capitalized_own_work_ratio inventory_change_ratio finance_to_ebt_ratio

Datenquelle

source_statement_date source_statement_type

Antwortbeispiele pro Feature

Gekürzte Ausschnitte aus echten Antworten — sie zeigen, welche JSON-Struktur jedes Feature der Antwort hinzufügt (Arrays mit "..." gekürzt):

financial_kpi 
"financial_kpi": [
  {
    "year": 2021,
    "revenue": 111239000000,
    "net_income": 12382000000,
    "active_total": 229527000000,
    "material_expenses": null,
    "personnel_expenses": null
  },
  "..."
]
network 
"network": {
  "depth": 2,
  "nodes": [
    { "node_id": "9dffc318...", "entity_id": "9dffc318...", "type": "ORGANIZATION",
      "name": "Beispielwerk Analytics GmbH", "depth": 0, "is_root": true },
    { "node_id": "c92a5b9a...", "entity_id": "c92a5b9a...", "type": "PERSON",
      "name": "Nina Weidmann", "depth": 1, "is_root": false },
    "..."
  ],
  "connections": [
    { "source": { "node_id": "c92a5b9a...", "type": "PERSON", "name": "Nina Weidmann" },
      "target": { "node_id": "9dffc318...", "type": "ORGANIZATION", "name": "Beispielwerk Analytics GmbH" },
      "connection_type": "ROLE", "label": "MANAGING_DIRECTOR",
      "role": { "en": { "long": "Managing Director", "short": "MD" },
                "de": { "long": "Geschaeftsfuehrer", "short": "GF" } },
      "start_date": "2020-06-01", "end_date": null, "is_current": true, "depth": 1 },
    "..."
  ]
}
balance_sheet_accounts 
"balance_sheet_accounts": [
  {
    "year": 2024,
    "balance_sheet_accounts": [
      {
        "name": {"de": "Aktivseite", "en": "Assets", "in_report": "Aktiva"},
        "value": 267732000000,
        "children": [
          {
            "name": {"de": "Aktuelle Anlagen", "en": "Current Assets", "in_report": "..."},
            "value": 96387000000,
            "children": ["..."]
          },
          "..."
        ]
      },
      "..."
    ]
  },
  "..."
]
profit_and_loss_account 
"profit_and_loss_account": [
  {
    "year": 2024,
    "profit_and_loss_accounts": [
      {
        "name": {"de": "Umsatzerlöse", "en": "Revenue", "in_report": "Umsatzerlöse"},
        "value": 142380000000,
        "children": []
      },
      "..."
    ]
  },
  "..."
]
related_persons 
"related_persons": {
  "current": [
    {
      "entity_id": "80fd27f39a5c075f88d99f3e126442e0",
      "name": "Milan Dr. Nedeljkovic",
      "label": "BOARD_CHAIR",
      "role": {
        "en": {"long": "Board Chair", "short": "Board"},
        "de": {"long": "Vorsitzender des Vorstands", "short": "Vorstand"}
      },
      "start_date": "2026-05-15",
      "end_date": null,
      "birth_date": "1969-03-11",
      "name_parts": {"given": "Milan", "family": "Nedeljkovic", "canonical_name": "Dr. Nedeljkovic, Milan"},
      "titles": ["Dr."],
      "location": {"home": {"city": "Leipzig"}},
      "organization_representation_scheme": {
        "current": ["Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. ..."],
        "history": [
          {"value": ["..."], "effective_from": "2004-02-03", "effective_to": "2009-08-25"},
          "..."
        ]
      },
      "role_representation_scheme": {
        "current": ["einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich als Vertreter eines Dritten Rechtsgeschäfte abzuschließen."],
        "history": [
          {"value": ["..."], "effective_from": "2021-08-04", "effective_to": null}
        ]
      }
    },
    "..."
  ],
  "past": ["... (past roles carry the scheme under \"latest\" instead of \"current\")"]
}
publications → response key "history" 
"history": [
  {
    "entity_type": "EVENT",
    "name": {"en": "Change of legal form", "de": "Änderung der Rechtsform"},
    "description": {
      "short": {"en": "The company changed its legal form", "de": "Die Rechtsform wurde geändert"}
    },
    "start_date": "2018-09-28T00:00:00",
    "details": {
      "value": "Gesellschaft mit beschränkter Haftung",
      "linked_entities": {"organization": {"name": "OroraTech GmbH"}}
    }
  },
  "..."
]
insolvency_publications 
"insolvency_publications": [
  {
    "publication_date": "2026-05-05T00:00:00+00:00",
    "insolvency_id": "10 IN 56/26",
    "court_city": "Wiesbaden",
    "entity_name": "Teltec AG",
    "seat": "Mainz-Kastel",
    "register": "Wiesbaden, HRB 27296",
    "publication_label": "Eröffnung",
    "event_notice": "Am 05.05.2026 wurde eine Insolvenzbekanntmachung (Eröffnung) ..."
  },
  "..."
]
news 
"news": [
  {
    "id": "c204cffdcef222e543ae5c16",
    "title": "PTA-CMS: Bayerische Motoren Werke Aktiengesellschaft: ...",
    "source": "TradingView",
    "publication_date": "2026-07-20",
    "url": "https://de.tradingview.com/news/..."
  },
  "..."
]
annual_financial_statements 
"annual_financial_statements": [
  {
    "document_type": "Jahresabschluss",
    "document_date": "2026-04-16",
    "document_title": "Jahresabschluss zum Geschäftsjahr vom 01.01.2025 bis zum 31.12.2025",
    "language": "Deutsch",
    "year": 2025,
    "document_md": "| Bayerische Motoren Werke Aktiengesellschaft ... (full report as Markdown)"
  },
  "..."
]
shareholders 
"shareholders": {
  "total_capital": {"amount": 125193, "currency": "EUR"},
  "entries": [
    {
      "shareholder": {
        "entity_id": "960bf144c3eda5c99e3caab086644da1",
        "first_name": "Ingo",
        "last_name": "Baumann",
        "birth_date": "1971-02-27",
        "address": "Köln-Neustadt/Nord"
      },
      "contribution": {"amount": 566, "currency": "EUR"},
      "contribution_ratio": 0.00452,
      "role": {
        "label": "SHAREHOLDER",
        "en": {"long": "Shareholder", "short": "Shareholder"},
        "de": {"long": "Gesellschafter", "short": "Gesellschafter"}
      }
    },
    "..."
  ],
  "history": {
    "current_as_of": "2025-07-04",
    "past": [
      {
        "as_of": "2025-06-16",
        "data": {
          "total_capital": {"amount": 125193, "currency": "EUR"},
          "shareholders": ["... (same entry shape as \"entries\")"]
        }
      },
      "..."
    ]
  }
}
ubos 
"ubos": {
  "beneficial_owners": [
    {
      "person": {
        "entity_id": "99e133f16ed20bbe874dfb08f87f2e54",
        "name": "Thomas Grübler",
        "birth_date": "1991-09-20",
        "name_parts": {"given": "Thomas", "family": "Grübler", "canonical_name": "Grübler, Thomas"},
        "location": {"home": {"city": "München", "state": "Bayern", "country": "DEU"}}
      },
      "ownership_percentage": 6.3,
      "paths": [
        {
          "percentage": 6.3,
          "via": [{"depth": 1, "name": "Gruebler Ventures UG (haftungsbeschränkt)", "entity_id": "...", "step_percentage": 6.3}]
        }
      ]
    },
    "..."
  ],
  "unresolved_beneficial_owners": [
    {
      "reason": "no_further_shareholder_data",
      "entity_id": "0aedd216ca3a22f0204667d552fe0c82",
      "name": "ConActivity KG",
      "legal_form": "KG",
      "ownership_percentage": 10.53,
      "registration": {"court": "Frankfurt am Main", "register_type": "HRA", "register_number": "30787"},
      "via": []
    },
    "..."
  ]
}
shareholdings 
"shareholdings": {
  "holdings": {
    "current": [
      {
        "organization": {
          "entity_id": "c3b23cd03d57d302b938b74ce7fbc5e3",
          "name": "BMW M GmbH Gesellschaft für individuelle Automobile",
          "status": "ACTIVE",
          "legal_form": "GmbH",
          "address": {"city": "München", "state": "Bayern", "country": "DEU", "...": "..."},
          "registration": {"court": "München", "register_type": "HRB", "register_number": "44621"}
        },
        "ownership": {
          "percentage": 100,
          "contribution": {"amount": 50000, "currency": "DEM"}
        },
        "as_of": "2020-12-21"
      },
      "..."
    ]
  },
  "summary": {"total_current": 15}
}
mergers_and_acquisitions 
"mergers_and_acquisitions": {
  "transactions": [
    {
      "id": "9254b90f65271482a0cd4babd80814b6",
      "headline": {
        "en": "Result transfer agreement with Avemio AG concluded",
        "de": "Ergebnisabführungsvertrag mit Avemio AG geschlossen"
      },
      "type": {
        "category": "ENTERPRISE_AGREEMENT",
        "event_type": "GROUP.ENTERPRISE_AGREEMENT",
        "name": {"en": "Enterprise agreement", "de": "Unternehmensvertrag"}
      },
      "kind": {
        "label": "RESULT_TRANSFER",
        "name": {"en": "Result transfer agreement", "de": "Ergebnisabführungsvertrag"}
      },
      "role": {
        "label": "CONTROLLED",
        "en": {"long": "Controlled company", "short": "Controlled"},
        "de": {"long": "Beherrschtes Unternehmen", "short": "Beherrscht"}
      },
      "phase": "REGISTERED",
      "date": "2023-10-11",
      "dates": {"registered_at": "2023-10-11", "agreement_date": null, "resolution_date": null},
      "counterparties": [
        {
          "entity_id": "176ad1d2790f8150ac03f6644e52f02c",
          "name": "Avemio AG",
          "seat": "Düsseldorf",
          "registration": {"court": "Amtsgericht Düsseldorf", "register_type": "HRB", "register_number": "82980"},
          "role": {"label": "CONTROLLING", "en": {"short": "Controlling"}, "de": {"short": "Herrschend"}}
        }
      ],
      "description": "Ergebnisabführungsvertrag mit der Avemio AG abgeschlossen.",
      "register_entries": [{"registered_at": "2023-10-11", "description": "..."}]
    },
    "..."
  ],
  "succession": null,
  "control": {
    "controlled_by": [
      {
        "counterparty": {"entity_id": "...", "name": "Avemio AG", "role": {"label": "CONTROLLING", "...": "..."}},
        "via": {"label": "RESULT_TRANSFER", "name": {"en": "Result transfer agreement", "de": "Ergebnisabführungsvertrag"}},
        "loss_absorption_obligation": true,
        "since": "2023-10-11",
        "transaction_ids": ["9254b90f65271482a0cd4babd80814b6"]
      }
    ],
    "controls": [],
    "former": []
  },
  "summary": {
    "total_transactions": 7,
    "by_category": {
      "ENTERPRISE_AGREEMENT": {"count": 5, "name": {"en": "Enterprise agreement", "de": "Unternehmensvertrag"}},
      "MERGER": {"count": 1, "name": {"en": "Merger", "de": "Verschmelzung"}}
    },
    "first_date": "2013-09-03",
    "last_date": "2024-08-14"
  }
}
website_content 
"website_content": "# Company Name\n\nStructured Markdown extracted from the company website ..."