fetch-organization
Endpoints
GET

/v1/fetch-organization

5-21 kreditter • 60/min

Hent omfattende informasjon om et tysk selskap inkludert juridisk status, finansielle data, ledelse og mer.

Parametere

Navn Type Påkrevd Beskrivelse
api_key string Betinget* Din API-nøkkel. Påkrevd hvis du ikke bruker x-api-key header eller Bearer token
q string PÅKREVD Bedriftsnavn, registreringsnummer eller søkeforespørsel
feature string valgfri Ytterligere datafunksjon å inkludere. Kan spesifiseres flere ganger (se funksjonstabellen nedenfor)
ai_search string valgfri Aktiver AI-søk. Verdier: on-default eller la parameteren være helt tom
realtime_mode string valgfri 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.

Tilgjengelige funksjoner

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

Eksempel på forespørsel

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'

Eksempel på svar

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

Svarstruktur detaljer

Grunnleggende bedriftsdata

Alltid inkludert: 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 av årlige finansielle nøkkeltall (omsetning, nettoinntekt, ansatte, etc.) over flere år

balance_sheet_accounts

Hierarkiske balansedata med oppdelning av eiendeler og gjeld per år

profit_and_loss_account

Detaljerte resultatregnskap med omsetning, utgifter og resultatoppdelning per år

related_persons

Nåværende og tidligere direktører/tjenestemenn med roller, navn og tjenesteperioder

publications

Offisielle handelsregisterpublikasjoner og kunngjøringer

news

Array av nyhetsartikler med tittel, kilde, publiseringsdato og URL

insolvency_publications

Insolvensdomstolspublikasjoner med datoer, saks-IDer og hendelsesdetaljer

annual_financial_statements

Fullstendige årsrapporter i markdown-format med metadata

annual_financial_statements__html

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

shareholders Beta

Liste over selskapets aksjonærer med eierskapsprosenter og roller

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