aktiv

heartbytes GmbH GmbH

Nürnberg ·HRB 34316 Nürnberg ·heartbytes.de

Teil 1 / 2

Strukturierte Daten

Geparste, typisierte und über die API direkt abfragbare Felder.

Stammdaten

Rechtsform: GmbH
Anschrift: Nimrodstraße 9 Haus 3
90441 Nürnberg
Handelsregister: HRB 34316, Nürnberg
Eintragungsdatum: 16. August 2017
Branche: Erbringung von Beratungsleistungen auf dem Gebiet der Informationstechnologie
Erbringung von sonstigen Dienstleistungen der Informationstechnologie
Betrieb von Datenverarbeitungseinrichtungen für Dritte
Unternehmenszweck: Entwicklung und Vertrieb von EDV Hard- und Software, Digital Services mit Schwerpunkt Internet, Consulting-Leistungen im IT-Bereich sowie Internet-Providing.

Softwareentwicklung Webentwicklung App-Entwicklung Social Media Marketing Hosting Softwareentwicklung Webentwicklung Online-Marketing Consulting IT-Infrastruktur

Finanzen

Für dieses Unternehmen sind keine Geschäftszahlen veröffentlicht.

Vertretungsberechtigte

Michael Waldmann seit 2017 Geschäftsführer

Eigentum & Beteiligungen

Gesellschafter

MiWa Beteiligungen UG (haftungsbeschränkt) DEU Amtsgericht Nürnberg, HRB 34284 100,0 % 25k €

Wirtschaftlich Berechtigte (UBOs)

1 mit ≥ 25 %

1 weitere wirtschaftlich Berechtigte · mit API-Key einsehbar API-Key holen →

Historie

2018
05.03.

Adressänderung

heartbytes GmbH
2017
21.08.

Eintritt eines Mitglieds

Michael Waldmann · Geschäftsführer
21.08.

Änderung der Rechtsform

Gesellschaft mit beschränkter Haftung
21.08.

Ersteintragung

heartbytes GmbH
21.08.

Sitzänderung

heartbytes GmbH
21.08.

Adressänderung

heartbytes GmbH
21.08.

Satzungsänderung

heartbytes GmbH
21.08.

Änderung des Unternehmensgegenstands

Entwicklung und Vertrieb von EDV Hard- und Software, Digital Services mit Schwerpunkt Internet, Consulting-Leistungen im IT-Bereich sowie Internet-Providing.

3 weitere Einträge API-Key holen →

Teil 2 / 2

Rohdaten & Dokumente

Originaldokumente, Markdown-Volltexte und PDFs – Volltext-Zugriff über die API.

Registerdokumente

PDF-Dokumente direkt vom Amtsgericht – auf Anfrage über den :code Endpunkt abrufbar.

Aktueller Auszug (AD)
Chronologischer Auszug (CD)
Strukturierte Inhalte (SI, XML)
Gesellschafterliste
Satzung / Gesellschaftsvertrag

Mit API-Key abrufen API-Key holen →

Website-Inhalt

Strukturierter Markdown-Volltext der Unternehmenswebsite – ideal für Anreicherung und AI-Pipelines.

heartbytes.de AI

Mit API-Key abrufen API-Key holen →

Live API

GEThandelsregister.ai/api/v1/fetch-organization

?q=17f8367b4cffce42272c7911ca34bf89

&features=related_persons

&features=shareholders

&features=ubos

&features=history

curl -H 'X-API-KEY: YOUR_API_KEY' \
  "https://handelsregister.ai/api/v1/fetch-organization?q=17f8367b4cffce42272c7911ca34bf89&features=related_persons&features=shareholders&features=ubos&features=history"

# pip install handelsregister
from handelsregister import Handelsregister

client = Handelsregister(api_key="YOUR_API_KEY")  # or set HANDELSREGISTER_API_KEY
organization = client.fetch_organization(
    q="17f8367b4cffce42272c7911ca34bf89",
    features=[
        "related_persons",
        "shareholders",
        "ubos",
        "history",
    ],
)
print(organization["name"])

// npm install handelsregister
import { Handelsregister } from 'handelsregister';

const client = new Handelsregister('YOUR_API_KEY'); // or set HANDELSREGISTER_API_KEY
const organization = await client.fetchOrganization({
  q: '17f8367b4cffce42272c7911ca34bf89',
  features: [
    'related_persons',
    'shareholders',
    'ubos',
    'history',
  ],
});
console.log(organization.name);

// npm install handelsregister
const { Handelsregister } = require('handelsregister');

const client = new Handelsregister(process.env.HANDELSREGISTER_API_KEY);
(async () => {
  const organization = await client.fetchOrganization({
    q: '17f8367b4cffce42272c7911ca34bf89',
    features: [
      'related_persons',
      'shareholders',
      'ubos',
      'history',
    ],
  });
  console.log(organization.name);
})();

{
    "entity_id": "<32-char hex>",
    "name": "<string>",
    "status": "<enum: ACTIVE | TERMINATED | DISSOLVED | INSOLVENT>",
    "legal_form": "<string>",
    "address": {
        "house_number": "<string>",
        "street": "<string>",
        "postal_code": "<string>",
        "city": "<string>",
        "county": "<string>",
        "state": "<string>",
        "country": "<ISO country>",
        "coordinates": {
            "latitude": "<float>",
            "longitude": "<float>"
        }
    },
    "registration": {
        "court": "<string>",
        "register_type": "<string>",
        "register_number": "<string>"
    },
    "registration_date": "<ISO date>",
    "purpose": "<string>",
    "keywords": [
        "<string>"
    ],
    "products_and_services": [
        "<string>"
    ],
    "contact_data": {
        "website": "<URL>",
        "phone_number": "<phone>",
        "email": "<email>"
    },
    "industry_classification": {
        "WZ2008": [
            {
                "code": "<string>",
                "label": "<string>"
            }
        ],
        "WZ2025": [
            {
                "code": "<string>",
                "label": "<string>"
            }
        ]
    },
    "representation_scheme": {
        "current": [
            "<string>"
        ],
        "history": [
            {
                "value": [
                    "<string>"
                ],
                "effective_from": "<string>",
                "effective_to": null
            }
        ]
    },
    "related_persons": {
        "current": [
            {
                "entity_id": "<32-char hex>",
                "label": "<string>",
                "role": {
                    "en": {
                        "long": "<string>",
                        "short": "<string>"
                    },
                    "de": {
                        "long": "<string>",
                        "short": "<string>"
                    }
                },
                "name": "<string>",
                "start_date": "<ISO date>",
                "end_date": null,
                "birth_date": null,
                "name_parts": {
                    "given": "<string>",
                    "family": "<string>",
                    "maiden": null,
                    "canonical_name": "<string>",
                    "previous_names": null
                },
                "location": {
                    "home": {
                        "city": "<string>"
                    }
                },
                "organization_representation_scheme": {
                    "current": [
                        "<string>"
                    ],
                    "history": [
                        {
                            "value": [
                                "<string>"
                            ],
                            "effective_from": "<string>",
                            "effective_to": null
                        }
                    ]
                },
                "role_representation_scheme": {
                    "current": [
                        "<string>"
                    ],
                    "history": [
                        {
                            "value": [
                                "<string>"
                            ],
                            "effective_from": "<string>",
                            "effective_to": null
                        }
                    ]
                }
            }
        ],
        "past": []
    },
    "annual_financial_statements__html": [],
    "profit_and_loss_account": [],
    "financial_kpi": [],
    "ubos": {
        "beneficial_owners": [
            {
                "person": {
                    "entity_id": "<32-char hex>",
                    "name": "<string>",
                    "birth_date": null,
                    "name_parts": {
                        "given": "<string>",
                        "family": "<string>",
                        "canonical_name": "<string>"
                    },
                    "location": {
                        "home": {
                            "city": "<string>",
                            "county": "<string>",
                            "state": "<string>",
                            "country": "<ISO country>"
                        }
                    }
                },
                "ownership_percentage": "<float>",
                "paths": [
                    {
                        "percentage": "<float>",
                        "via": [
                            {
                                "depth": "<int>",
                                "name": "<string>",
                                "entity_id": "<32-char hex>",
                                "step_percentage": "<float>"
                            }
                        ]
                    }
                ]
            }
        ],
        "unresolved_beneficial_owners": [],
        "coverage": {
            "resolved_percentage": "<float>",
            "unresolved_percentage": "<int>"
        }
    },
    "shareholders": {
        "total_capital": {
            "amount": "<float>",
            "currency": "<ISO currency>"
        },
        "entries": [
            {
                "shareholder": {
                    "entity_id": "<32-char hex>",
                    "entity_name": "<string>",
                    "address": "<string>",
                    "country_code": "<ISO country>",
                    "registration_reference": "<string>"
                },
                "contribution": {
                    "amount": "<float>",
                    "currency": "<ISO currency>"
                },
                "contribution_ratio": "<float>",
                "role": {
                    "label": "<string>",
                    "en": {
                        "long": "<string>",
                        "short": "<string>"
                    },
                    "de": {
                        "long": "<string>",
                        "short": "<string>"
                    }
                }
            }
        ],
        "history": null
    },
    "shareholdings": null,
    "balance_sheet_accounts": [],
    "capital": {
        "current": {
            "amount": "<float>",
            "currency": "<ISO currency>",
            "kind": "<string>"
        },
        "history": [
            {
                "value": {
                    "amount": "<float>",
                    "currency": "<ISO currency>",
                    "kind": "<string>"
                },
                "effective_from": "<string>",
                "effective_to": null
            }
        ]
    },
    "history": [
        {
            "entity_type": "<string>",
            "name": {
                "de": "<string>",
                "en": "<string>"
            },
            "description": {
                "short": {
                    "de": "<string>",
                    "en": "<string>"
                }
            },
            "start_date": "<ISO date>",
            "details": {
                "value": {
                    "role": {
                        "name": "<string>",
                        "original_name_source": "<string>",
                        "representation_scheme": [
                            "<string>"
                        ]
                    }
                },
                "linked_entities": {
                    "person": {
                        "name": {
                            "given": "<string>",
                            "family": "<string>"
                        }
                    },
                    "organization": {
                        "name": "<string>"
                    }
                }
            }
        }
    ]
}

Basis-Felder

entity_id string

Stabile handelsregister.ai-ID (32-stelliger Hex-String).

name string

Eingetragener Firmenname.

status enum

ACTIVE, TERMINATED, DISSOLVED oder INSOLVENT.

legal_form string

Rechtsform (GmbH, AG, KG, …), sofern vorhanden.

address object

Postanschrift mit street, house_number, postal_code, city, county, state, country und coordinates.

registration object

Registereintrag mit court, register_type und register_number.

registration_date date

Datum der Ersteintragung im Handelsregister (ISO).

purpose string

Unternehmensgegenstand laut Eintragung.

representation_scheme object

Allgemeine Vertretungsregelung: { current: [...], history: [...] } mit effective_from/effective_to je Fassung.

capital object

Eingetragenes Kapital: { current, history }. current enthält amount, currency und kind (STAMMKAPITAL, GRUNDKAPITAL, HAFTSUMME, GENEHMIGTES_KAPITAL, BEDINGTES_KAPITAL, VARIABLES_KAPITAL — offene Liste); jeder history-Eintrag hat value, effective_from und effective_to (null = weiterhin gültig). change_amount eines history-Eintrags ist vorzeichenlos und entspricht nicht immer der Differenz zweier aufeinanderfolgender Beträge — Erhöhungen und Herabsetzungen daher aus den Beträgen ableiten. Personengesellschaften und andere Rechtsträger ohne eingetragenes Kapital liefern current: null und eine leere history.

contact_data object

website, phone_number und email, soweit ermittelbar.

industry_classification object

Branchencodes nach WZ2008 und WZ2025 mit Labels.

keywords array<string>

Stichworte, abgeleitet aus dem Unternehmensgegenstand.

products_and_services array<string>

Produkt- und Dienstleistungsbeschreibungen, soweit ermittelbar.

history array<object>

Chronologisches Protokoll aller Registeränderungen (Name, Sitz, Kapital, Vertretung, …).

features=financial_kpi

financial_kpi array<object>

Pro Geschäftsjahr: revenue, employees, active_total (Bilanzsumme), net_income, material_expenses, personnel_expenses.

features=balance_sheet_accounts

balance_sheet_accounts array<object>

Pro Geschäftsjahr: hierarchische Bilanzpositionen aus dem veröffentlichten Jahresabschluss.

features=profit_and_loss_account

profit_and_loss_account array<object>

Pro Geschäftsjahr: hierarchische Positionen der Gewinn- und Verlustrechnung.

features=related_persons

related_persons object

Vertretungsberechtigte Personen: { current: [...], past: [...] } — Geschäftsführer, Vorstände, Prokuristen. Jede Person enthält organization_representation_scheme und role_representation_scheme (aktuelle Regelung + Historie).

features=shareholders

shareholders object

Gesellschafter: { total_capital, entries: [...], history: { current_as_of, past: [...] } }. Jeder entry enthält shareholder, contribution, contribution_ratio und role; history.past liefert frühere Gesellschafterlisten mit as_of-Datum. total_capital, contribution und contribution_ratio können null sein (z. B. bei Personengesellschaften).

features=ubos

ubos object

Wirtschaftlich Berechtigte: { beneficial_owners, unresolved_beneficial_owners, coverage } gemäß Transparenzregister.

features=shareholdings

shareholdings object

Beteiligungen dieses Unternehmens: { holdings: { current: [...] }, summary }. Jede Beteiligung verlinkt eine andere Organisation per entity_id.

features=publications

publications array<object>

Amtliche Bekanntmachungen aus dem Handelsregister (Datum, Titel, Volltext).

features=annual_financial_statements__html

annual_financial_statements__html array<object>

Veröffentlichte Jahresabschlüsse mit document_html (gerendertes HTML), document_type, document_title, document_date, language und year.

Profil · Finanzen · Personen · Dokumente

Strukturierte Daten und Volltexte – pro Unternehmen

Vom Jahresabschluss als HTML bis zur UBO-Liste: jedes Feld einzeln über den features Parameter aktivierbar. Eine API, alle Daten.

Geschäftszahlen Umsatz, Mitarbeiterzahl, Bilanzsumme, Jahresergebnis pro Geschäftsjahr.
Vertretungsberechtigte Aktuelle und ehemalige Geschäftsführer, Vorstände, Prokuristen mit Rollen und Datumsangaben.
Bekanntmachungen Amtliche Bekanntmachungen aus dem Handelsregister inkl. Datum und Volltext.
Gesellschafter Aktuelle Gesellschafterstruktur mit Beteiligungsquoten und Einlagebeträgen.
Wirtschaftlich Berechtigte (UBOs) Wirtschaftlich Berechtigte gemäß Transparenzregister.
Beteiligungen Beteiligungen dieses Unternehmens an anderen Gesellschaften.
Bilanz Vollständige Bilanzpositionen aus den veröffentlichten Jahresabschlüssen.
Gewinn- und Verlustrechnung GuV-Positionen pro Geschäftsjahr.
Jahresabschlüsse (HTML) Veröffentlichte Jahresabschlüsse als gerendertes HTML.
Insolvenzbekanntmachungen Bekanntmachungen aus den amtlichen Insolvenzregistern.
News Aktuelle Erwähnungen des Unternehmens aus externen Quellen.

Alle Felder mit API-Key freischalten API-Key holen →

Code · AI-Agents · No-Code · Workflows

In jeden Stack einbaubar

Egal ob klassische API, AI-Agent oder No-Code-Tool – diese Daten lassen sich überall andocken.

REST API Einfacher GET-Aufruf mit X-API-KEY Header. Kompatibel mit jedem HTTP-Client. Python Funktioniert mit requests, httpx oder Ihrer bevorzugten Bibliothek. Node.js Standard fetch oder axios – kein zusätzliches SDK erforderlich. MCP Server Direkt in Claude, Cursor oder andere MCP-fähige AI-Clients einbinden. n8n Vorgefertigter Custom Node für Workflow-Automatisierung in n8n. Webhook Aufrufbar aus Zapier, Make oder jeder anderen Webhook-Plattform.

Diese Daten in Ihrer App

Holen Sie sich einen API-Key und verwenden Sie diese strukturierten Handelsregisterdaten direkt aus Ihrer Anwendung – ohne Scraping, ohne PDFs.

API Key holen