fetch-organization
Endpoints
GET

/v1/fetch-organization

5-21 crédits • 60/min

Récupère des informations complètes sur une entreprise allemande incluant le statut légal, les données financières, la gestion et plus.

Paramètres

Nom Type Requis Description
api_key string Conditionnel* Votre clé API. Requise si vous n'utilisez pas l'en-tête x-api-key ou le token Bearer
q string REQUIS Nom d'entreprise, numéro d'enregistrement ou requête de recherche
feature string optionnel Fonctionnalité de données supplémentaire à inclure. Peut être spécifiée plusieurs fois (voir tableau des fonctionnalités ci-dessous)
ai_search string optionnel Activer la recherche AI. Valeurs : on-default ou laisser le paramètre complètement
realtime_mode string optionnel 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.

Fonctionnalités Disponibles

financial_kpi 1 crédit
balance_sheet_accounts 3 crédits
profit_and_loss_account 3 crédits
related_persons 2 crédits
publications 1 crédit
news 10 crédits
insolvency_publications 5 crédits
annual_financial_statements 5 crédits
annual_financial_statements__html 5 Credits
shareholders Beta
5 crédits
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.

Exemple de Requête

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'

Exemple de Réponse

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

Détails de la Structure de Réponse

Données Principales de l'Entreprise

Toujours incluses : 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

Tableau de métriques financières annuelles (revenus, revenu_net, employés, etc.) sur plusieurs années

balance_sheet_accounts

Données de bilan hiérarchiques avec répartition des actifs et passifs par année

profit_and_loss_account

États de profits et pertes détaillés avec répartition des revenus, dépenses et bénéfices par année

related_persons

Directeurs/dirigeants actuels et passés avec rôles, noms et périodes de mandat

publications

Publications et annonces officielles du registre commercial

news

Tableau d'articles de presse avec titre, source, date de publication et URL

insolvency_publications

Publications du tribunal d'insolvabilité avec dates, IDs de cas et détails d'événements

annual_financial_statements

Rapports annuels complets en format markdown avec métadonnées

annual_financial_statements__html

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

shareholders Beta

Liste des actionnaires de l'entreprise avec pourcentages de propriété et rôles

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 ..."