fetch-organization
Endpoints
GET

/v1/fetch-organization

5-21 credite • 60/min

Obțineți informații cuprinzătoare despre o companie germană, inclusiv statutul legal, datele financiare, managementul și multe altele.

Parametri

Nume Tip Necesar Descriere
api_key string Condițional* Cheia dvs. API. Necesară dacă nu utilizați antetul x-api-key sau token Bearer
q string NECESAR Nume companie, număr de înregistrare sau interogare de căutare
feature string opțional Funcție de date suplimentară de inclus. Poate fi specificată de mai multe ori (vezi tabelul de funcții de mai jos)
ai_search string opțional Activează căutarea AI. Valori: on-default sau lăsați parametrul complet gol
realtime_mode string opțional 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.

Funcții disponibile

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

Exemplu de cerere

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'

Exemplu de răspuns

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

Detalii structură răspuns

Date de bază ale companiei

Întotdeauna incluse: 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 de indicatori financiari anuali (venituri, venit net, angajați, etc.) pe mai mulți ani

balance_sheet_accounts

Date ierarhice de bilanț cu defalcarea activelor și pasivelor pe an

profit_and_loss_account

Declarații detaliate de profit și pierderi cu defalcarea veniturilor, cheltuielilor și profitului pe an

related_persons

Directori/funcționari actuali și anteriori cu roluri, nume și perioade de mandat

publications

Publicații și anunțuri oficiale din registrul comercial

news

Array de articole de știri cu titlu, sursă, data publicării și URL

insolvency_publications

Publicații ale tribunalului de insolvență cu date, ID-uri de cazuri și detalii ale evenimentelor

annual_financial_statements

Rapoarte anuale complete în format markdown cu metadate

annual_financial_statements__html

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

shareholders Beta

Lista acționarălor companiei cu procente de proprietate și roluri

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