Handelsregister-Unternehmenshistorie (Publikationen)

1Wie die Daten geliefert werden

Die Historie wird über den generischen relation‑resolve-Endpunkt abgerufen, unter Verwendung der relation_id für Organisationspublikationen:

POST /api/v2/resolve/2533389984/{fb_entity_id}

• {fb_entity_id} — die 32‑stellige id der Organisation, deren Historie Sie abrufen möchten.
• Optionaler Request-Body: { "params": { ... } } (für diese Relation sind keine Parameter erforderlich).

Die Antwort ist ein JSON-Array. Jedes Array-Element ist ein Historienereignis, eingebettet in einen kleinen Relations-Envelope. Das eigentliche Ereignis befindet sich unter dem Schlüssel entity jedes Elements (siehe §3). Ein leeres Array ([]) bedeutet, dass für diese Organisation keine Historienereignisse verfügbar sind.

Registereinträge sind Neueintragung (Ersteintragung), Veränderung (Änderung) oder Löschung. Die Ereignisse bilden dies ab: Rollen-/Mitgliedsereignisse sind Personen, die einem Unternehmen beitreten oder es verlassen; Organisationsänderungsereignisse sind Änderungen der eigenen Stammdaten eines Unternehmens.

3Antwortstruktur

3.1 Antwort-Envelope (Array-Element)

Jedes Array-Element enthält ausschließlich diese Schlüssel der obersten Ebene:

entity_from (das Unternehmen)

entity_to (Referenz auf das Ereignis)

3.2 Das entity-Objekt (das Ereignis)

Diese Schlüssel sind bei jedem Ereignis immer vorhanden (der Wert kann null sein):

3.3 details — Rollen-/Mitgliedsereignisse

Bei Rollen-/Mitgliedsereignissen (MEMBER_* und AUTHORITY_CHANGE) trägt details ein value.role, das die Rolle beschreibt, sowie einen linked_entities-Block, der die Beteiligten benennt.

3.4 details — Organisationsänderungsereignisse

Bei Organisationsänderungsereignissen (NAME_CHANGE, LEGAL_FORM_CHANGE, SEAT_CHANGE, ADDRESS_CHANGE, COURT_CHANGE, CAPITAL_CHANGE, PURPOSE_CHANGE, REPRESENTATION_SCHEME_CHANGE, STATUS_CHANGE) trägt details.value den neuen Wert nach der Änderung, und linked_entities.organization benennt das Unternehmen.

3.5 Gemeinsame Unterobjekte

LOCATION

Verwendet von details.value bei SEAT_CHANGE / ADDRESS_CHANGE sowie für den Gerichtsstandort bei COURT_CHANGE. Die nützlichen Felder:

Dieses Objekt ist ein vollständiger Standortdatensatz und trägt daher zusätzlich Identifikator- und Geo-Felder. In Live-Antworten beobachtet: fb_entity_id, fb_entity_version, fb_datetime, location_level (oft null), elevation (oft null) und alternative_names (oft []). Behandeln Sie diese als Extras — verlassen Sie sich auf die Felder in der Tabelle oben.

MonetaryAmount

Der CAPITAL_CHANGE-Wert: { "@type": "MonetaryAmount", "value": float, "currency": string }.

Registergericht (COURT_CHANGE-Wert)

Das neue Gericht. Die Felder sind verschachtelt unter registration_authority.local:

"value": {
  "registration_authority": {
    "local": {
      "registration_authority_id": "string",
      "registration_authority_name": "string",        // court town, e.g. "Kempten"
      "registration_authority_entity_id": "string",
      "registration_authority_entity_name": "string", // e.g. "Kempten HRB 16388"
      "registration_type": "string|null",             // HRA / HRB / PR / VR
      "registration_number": "string",
      "registration_id_extra": "string|null",
      "registration_authority_location": { /* LOCATION, may be null */ }
    }
  },
  "legal_form": { "label": { "de": { "short": "GmbH" } } }   // optional, only when present
}

Personenname

details.linked_entities.person.name: { given: string, family: string, maiden: string|null, aliases: array<string> }. maiden ist üblicherweise null; aliases ist üblicherweise ein leeres Array. (Die Blöcke person und organization selbst sind auf fb_entity_id + name reduziert.)

3.6 Felder, die nicht in der Antwort enthalten sind

Um die Antwort fokussiert zu halten, sind die folgenden nicht Teil davon — bauen Sie nicht darauf:

• Ereignis-Zeitstempel und zusätzliche Identifikatoren: es gibt keine created_at / updated_at / fb_datetime-Zeitstempel und kein raw_data, fb_semantic_id oder external_ids auf Ereignisebene.
• source: enthält nur { "id": ... } — keine weiteren Quellfelder.
• details: enthält nur value und linked_entities. Es sind keine weiteren Kontextfelder vorhanden (z. B. Belegauszüge, Korrekturumfang oder Feldschlüssel).
• details.linked_entities: enthält nur person und/oder organization. Es treten keine weiteren Beteiligten-Blöcke auf, und Ereignisse, deren Rolle von einer Organisation gehalten wird, sind nicht Teil dieser Antwort.
• Nicht enthaltene Ereignistypen: Ereignisse mit category OTHER_PERSON_EVENT oder PERSONAL_DATA_CORRECTED werden nie zurückgegeben.

3.7 Gültigkeitsintervalle (meta.start_date / meta.end_date)

Die Liste ist ein flacher Strom zeitpunktbezogener Ereignisse; meta macht daraus abfragbare Historie, indem es jedem Ereignis ein Gültigkeitsintervall [start_date, end_date) zuordnet:

• meta.start_date — der Zeitpunkt, ab dem dieser Wert wirksam wurde.
• meta.end_date — der Zeitpunkt, zu dem dieser Wert durch den nächsten Wert im selben Zeitstrang abgelöst wurde, oder null, wenn dies der aktuelle Wert ist.

Um den aktuellen Stand eines beliebigen Attributs zu lesen, nehmen Sie also das Ereignis in diesem Zeitstrang, dessen meta.end_date null ist. (Hinweis: entity.end_date ist ein anderes Feld — es ist das eigene Ende des Ereignisses und immer null; das Intervall liegt in meta.)

Zeitstränge

Ereignisse werden in unabhängige Zeitstränge gruppiert, und Intervalle werden innerhalb jedes Zeitstrangs geschlossen (sortiert nach start_date; das jüngste bleibt offen):

• Organisationsänderungen — ein Zeitstrang pro category. Z. B. bilden alle SEAT_CHANGE-Ereignisse die Sitzhistorie; das offene ist der aktuelle Sitz.
• Mitglieds-/Rollenereignisse — ein Zeitstrang pro (person, role). Die Amtszeit einer Person als Managing Director wird unabhängig von ihrer Amtszeit als Procura verfolgt, und zwei verschiedene Personen, die dieselbe Rolle innehaben, bilden unabhängige Zeitstränge. Ein MEMBER_ENTRY wird beim start_date des nächsten Ereignisses dieser Person in derselben Rolle geschlossen (typischerweise deren MEMBER_EXIT_POSITION); das jüngste Ereignis für das Paar bleibt offen.

Durchgerechnetes Beispiel — zwei SEAT_CHANGE-Ereignisse:

{ "category": "SEAT_CHANGE", "meta": { "start_date": "2014-03-24…", "end_date": "2014-12-16…" } }  // superseded
{ "category": "SEAT_CHANGE", "meta": { "start_date": "2014-12-16…", "end_date": null } }            // current seat

4Ereigniskatalog & Semantik

Alle zurückgegebenen Ereignisse haben entity_type = "EVENT" und entity_subtype = "PUBLICATION"; das Feld category wählt die Art des Ereignisses aus.

A · Rollen-/Mitgliedsereignisse (Person ↔ Unternehmen)

Diese beschreiben, wer welche Leitungs- oder Vertretungsrolle bei einem Unternehmen innehatte und wann. Die Rolle wird in details.value.role.name ins Englische normalisiert, mit dem ursprünglichen deutschen Begriff in original_name_source. Übliche Registerrollen:

B · Organisationsänderungsereignisse (Unternehmensstammdaten)

Veränderungen der eigenen Stammdaten des Unternehmens; jedes trägt den neuen Wert in details.value.

5Feldwerte / Enumerationen

Konstanten

entity_type = EVENT · entity_subtype = PUBLICATION.

status

Einer von ISSUED, ONGOING, CANCELLED, FINISHED. Registerpublikationen sind historische Tatsachen und normalerweise FINISHED.

category

category bestimmt die Art des Ereignisses. Die Werte, die Ihnen bei deutschen Handelsregister-Unternehmen begegnen, sind:

• Rolle / Mitglied: MEMBER_ENTRY, MEMBER_EXIT_POSITION, MEMBER_ENTRY_EXIT, MEMBER_NEW_POSITION, MEMBER_RETURN, MEMBER_CHANGE, MEMBER_EXIT_UNKNOWN.
• Personen-/Entitätsereignisse: AUTHORITY_CHANGE, ENTITY_DATA_CORRECTED, OTHER_ENTITY_EVENT.
• Organisationsänderungen: NAME_CHANGE, LEGAL_FORM_CHANGE, PURPOSE_CHANGE, COURT_CHANGE, SEAT_CHANGE, ADDRESS_CHANGE, STATUS_CHANGE, CAPITAL_CHANGE, REPRESENTATION_SCHEME_CHANGE.

Rollennamen (details.value.role.name)

Zu den Rollennamen, die Sie für das deutsche Register erwarten können, gehören: Managing Director, Temporary Managing Director, Director, Board Member, Board Chair, Supervisory Board, Limited Partner, Fully Liable Partner, Partner, Shareholder, Owner, Proprietor, Procura, Representative, Signatory, Liquidator und Insolvency Administrator. Dies ist nicht erschöpfend — andere Werte können auftreten, behandeln Sie Rollennamen daher als offene Menge.

Weitere Wertemengen (datengetrieben, als offen behandeln)

Währung (CAPITAL_CHANGE): EUR, DEM, GBP, … (ISO‑4217-Codes).

Registerart (COURT_CHANGE): HRA, HRB, PR, VR.

Location-Subtyp: z. B. LOCALITY, STREET, CITY_POSTAL_CODE, CITY_NO_POSTAL_CODE.

6Beispiele

6.1 Mitgliedseintritt — Managing Director (start_date null)

Eine Geschäftsführer-Bestellung. Der Eintrag erfasste kein parsbares Beginndatum, daher ist start_date null. Der Vertretungstext (Einzelvertretung + Befreiung von § 181 BGB) ist in representation_scheme erhalten.

{
  "label": "PUBLICATION",
  "entity_from": {
    "fb_entity_id": "8bb2b58c965ce9920531bce5f9b7943b",
    "entity_type": "ORGANIZATION",
    "display_name": "Quatalis GmbH",
    "attributes": { "display_name": { "en": "Quatalis GmbH" } }
  },
  "entity_to": {
    "fb_entity_id": "269223b8a4ce94b85652b5e814cdd92f",
    "entity_type": "EVENT",
    "attributes": { "display_name": { "de": "Eintritt eines Mitglieds", "en": "Member entry" } }
  },
  "meta": { "start_date": null, "end_date": null },
  "entity": {
    "fb_entity_id": "269223b8a4ce94b85652b5e814cdd92f",
    "entity_type": "EVENT",
    "entity_subtype": "PUBLICATION",
    "category": "MEMBER_ENTRY",
    "name": { "de": "Eintritt eines Mitglieds", "en": "Member entry" },
    "description": { "short": { "de": "Ein Mitglied ist dem Unternehmen beigetreten", "en": "A member has joined the company" } },
    "status": "FINISHED",
    "start_date": null,
    "announce_date": null,
    "live_date": null,
    "end_date": null,
    "origin_location": null,
    "event_location": null,
    "effect_location": null,
    "details": {
      "value": {
        "role": {
          "name": "Managing Director",
          "original_name_source": "Geschäftsführer",
          "responsibilities": null,
          "representation_scheme": [
            "mit der Befugnis die Gesellschaft allein zu vertreten; mit der Befugnis Rechtsgeschäfte mit sich selbst oder als Vertreter Dritter abzuschließen"
          ],
          "liability_deposit": null
        }
      },
      "linked_entities": {
        "person": {
          "fb_entity_id": "a3009f8357871f87d73eee0c2eb2b926",
          "name": { "given": "Johannes", "family": "Pfützner", "maiden": null, "aliases": [] }
        },
        "organization": { "fb_entity_id": "8bb2b58c965ce9920531bce5f9b7943b", "name": "Quatalis GmbH" }
      }
    },
    "source": { "id": "data_sources/1051122944" }
  },
  "source": { "id": "data_sources/1051122944" }
}

6.2 Organisation — Namensänderung

{
  "label": "PUBLICATION",
  "entity_from": {
    "fb_entity_id": "e79720c51aa09e8647cd879c7b1a5dfa",
    "entity_type": "ORGANIZATION",
    "display_name": "FILLITUP GmbH",
    "attributes": { "display_name": { "en": "FILLITUP GmbH" } }
  },
  "entity_to": {
    "fb_entity_id": "1be8dbbb5fed3079a7ff17e08af43ec3",
    "entity_type": "EVENT",
    "attributes": { "display_name": { "de": "Änderung des Unternehmensnamens", "en": "Change of company name" } }
  },
  "meta": { "start_date": "2022-07-15T00:00:00", "end_date": null },
  "entity": {
    "fb_entity_id": "1be8dbbb5fed3079a7ff17e08af43ec3",
    "entity_type": "EVENT",
    "entity_subtype": "PUBLICATION",
    "category": "NAME_CHANGE",
    "name": { "de": "Änderung des Unternehmensnamens", "en": "Change of company name" },
    "status": "FINISHED",
    "start_date": "2022-07-15T00:00:00",
    "announce_date": null,
    "live_date": null,
    "end_date": null,
    "origin_location": null,
    "event_location": null,
    "effect_location": null,
    "details": {
      "value": "FILLITUP GmbH",
      "linked_entities": {
        "organization": { "fb_entity_id": "e79720c51aa09e8647cd879c7b1a5dfa", "name": "FILLITUP GmbH" }
      }
    },
    "source": { "id": "data_sources/1051122944" }
  }
}

6.3 Organisation — Kapitaländerung

{
  "label": "PUBLICATION",
  "entity_from": {
    "fb_entity_id": "f2efce26b0ee72de3301e5525d61315f",
    "entity_type": "ORGANIZATION",
    "display_name": "ALLFINCON International GmbH",
    "attributes": { "display_name": { "en": "ALLFINCON International GmbH" } }
  },
  "entity_to": {
    "fb_entity_id": "da402f2e6da532704796daaacf81ad98",
    "entity_type": "EVENT",
    "attributes": { "display_name": { "de": "Kapitaländerung", "en": "Change of capital" } }
  },
  "meta": { "start_date": "2023-07-25T00:00:00", "end_date": null },
  "entity": {
    "fb_entity_id": "da402f2e6da532704796daaacf81ad98",
    "entity_type": "EVENT",
    "entity_subtype": "PUBLICATION",
    "category": "CAPITAL_CHANGE",
    "name": { "de": "Kapitaländerung", "en": "Change of capital" },
    "status": "FINISHED",
    "start_date": "2023-07-25T00:00:00",
    "announce_date": null,
    "live_date": null,
    "end_date": null,
    "origin_location": null,
    "event_location": null,
    "effect_location": null,
    "details": {
      "value": { "@type": "MonetaryAmount", "value": 66667.0, "currency": "EUR" },
      "linked_entities": {
        "organization": { "fb_entity_id": "f2efce26b0ee72de3301e5525d61315f", "name": "ALLFINCON International GmbH" }
      }
    },
    "source": { "id": "data_sources/1051122944" }
  }
}

6.4 Organisation — Adressänderung (abgelöst, geschlossenes Intervall)

Die neue Adresse ist eine geokodierte LOCATION unter details.value. Dieses Ereignis wurde durch eine spätere Adressänderung abgelöst, daher ist sein meta.end_date befüllt (gleich dem start_date des nächsten Adressereignisses) statt null — siehe §3.7.

{
  "label": "PUBLICATION",
  "entity_from": {
    "fb_entity_id": "1bd7295693c121f136c19f294d7747aa",
    "entity_type": "ORGANIZATION",
    "display_name": "SEDDIO UG (haftungsbeschränkt)",
    "attributes": { "display_name": { "en": "SEDDIO UG (haftungsbeschränkt)" } }
  },
  "entity_to": {
    "fb_entity_id": "e3f1c982ed08cb915acde5be741e9276",
    "entity_type": "EVENT",
    "attributes": { "display_name": { "de": "Adressänderung", "en": "Change of address" } }
  },
  "meta": { "start_date": "2009-06-16T00:00:00", "end_date": "2015-02-11T00:00:00" },
  "entity": {
    "fb_entity_id": "e3f1c982ed08cb915acde5be741e9276",
    "entity_type": "EVENT",
    "entity_subtype": "PUBLICATION",
    "category": "ADDRESS_CHANGE",
    "name": { "de": "Adressänderung", "en": "Change of address" },
    "status": "FINISHED",
    "start_date": "2009-06-16T00:00:00",
    "announce_date": null,
    "live_date": null,
    "end_date": null,
    "origin_location": null,
    "event_location": null,
    "effect_location": null,
    "details": {
      "value": {
        "fb_entity_id": "33d929f63a6b5fc578159aa0f970e076",
        "fb_datetime": "2024-06-25T14:12:36.947000+00:00",
        "fb_entity_version": "0ddb93255ebf23f761144fb244ba85e7",
        "entity_type": "LOCATION",
        "entity_subtype": "LOCALITY",
        "coordinate": { "latitude": 48.10646, "longitude": 11.53716 },
        "location_level": null,
        "address_components": [
          { "component_type": "house_number", "component_value": "2" },
          { "component_type": "street", "component_value": "Flößergasse" },
          { "component_type": "postal_code", "component_value": "81369" },
          { "component_type": "city", "component_value": "München" },
          { "component_type": "county", "component_value": "München (Stadt)" },
          { "component_type": "state", "component_value": "Bayern" },
          { "component_type": "country", "component_value": "Deutschland" }
        ],
        "elevation": null,
        "alternative_names": [],
        "formatted_address": "Flößergasse 2, 81369 München, Deutschland"
      },
      "linked_entities": {
        "organization": { "fb_entity_id": "1bd7295693c121f136c19f294d7747aa", "name": "SEDDIO UG (haftungsbeschränkt)" }
      }
    },
    "source": { "id": "data_sources/1051122944" }
  }
}

7Übersicht Nullbarkeit