Basisgegevens – Documentatie | handelsregister.ai

Voorbeeld

De voorbeelden op deze pagina komen uit een voorbeeldaanvraag voor Hetzner Online GmbH, Ansbach HRB 6089. Verandert de inschrijving, dan levert je eigen aanvraag andere waarden.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: JOUW_API_SLEUTEL" \
  --data-urlencode 'q=Hetzner Online GmbH'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "JOUW_API_SLEUTEL"},
    params={
        "q": "Hetzner Online GmbH",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-organization");
url.searchParams.append("q", "Hetzner Online GmbH");

const response = await fetch(url, {
  headers: { "x-api-key": "JOUW_API_SLEUTEL" },
});
const data = await response.json();

1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "status": "ACTIVE",5  "legal_form": "GmbH",6  "registration": {7    "court": "Ansbach",8    "register_type": "HRB",9    "register_number": "6089"10  },11  "keywords": [12    "Dedicated Server",13    "Cloud Hosting",14    "Webhosting",15    "Colocation",16    "Object Storage",17    "Domainregistrierung",18    "SSL-Zertifikate",19    "Web-Hosting-Unternehmen"20  ],21  "products_and_services": [22    "Dedizierte Root-Server (Dedicated Servers)",23    "Cloud-Server und virtuelle Server",24    "Managed Server",25    "Webhosting (Shared Hosting)",26    "Colocation Rack / Rechenzentrumsflächen",27    "Storage Box / Object Storage / Storage Share",28    "Domain-Registrierung",29    "SSL-Zertifikate",30    "Load Balancer",31    "DNS Console",32    "Registration Robot",33    "Custom Solutions"34  ],35  "industry_classification": {36    "WZ2008": [37      {38        "code": "62.01.0",39        "label": "Erbringung von Dienstleistungen der Informationstechnologie"40      },41      {42        "code": "63.11.0",43        "label": "Datenverarbeitung, Hosting und damit verbundene Tätigkeiten"44      },45      {46        "code": "61.90.0",47        "label": "Telekommunikation, sonstige"48      }49    ],50    "WZ2025": [51      {52        "code": "62.20.1",53        "label": "Erbringung von Beratungsleistungen auf dem Gebiet der Informationstechnologie"54      },55      {56        "code": "46.50.1",57        "label": "Großhandel mit Datenverarbeitungsgeräten, peripheren Geräten und Software"58      },59      {60        "code": "62.90.0",61        "label": "Erbringung von sonstigen Dienstleistungen der Informationstechnologie"62      }63    ]64  },65  "contact_data": {66    "website": "https://www.hetzner.com/",67    "phone_number": "09831 5050",68    "email": "[email protected]"69  },70  "address": {71    "house_number": "25",72    "street": "Industriestraße",73    "postal_code": "91710",74    "city": "Gunzenhausen",75    "county": "Weißenburg-Gunzenhausen",76    "state": "Bayern",77    "country": "DEU",78    "coordinates": {79      "latitude": 49.12483,80      "longitude": 10.7805281    }82  },83  "seat": {84    "city": "Gunzenhausen"85  },86  "registration_date": null,87  "representation_scheme": {88    "current": [89      "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."90    ],91    "history": [92      {93        "value": [94          "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."95        ],96        "effective_from": "2002-10-15",97        "effective_to": "2015-07-28"98      },99      {100        "value": [101          "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."102        ],103        "effective_from": "2015-07-28",104        "effective_to": null105      }106    ]107  },108  "capital": {109    "current": {110      "amount": 50000,111      "currency": "EUR",112      "kind": "STAMMKAPITAL"113    },114    "history": [115      {116        "value": {117          "amount": 50000,118          "currency": "EUR",119          "kind": "GRUNDKAPITAL"120        },121        "effective_from": "2002-10-15",122        "effective_to": null123      }124    ]125  },126  "purpose": "Die Durchführung von Internet- und Netzwerkdienstleistungen, das Erstellen und Vertreiben von Software, der Handel mit Hard- und Software, der Betrieb einer Werbeagentur,darüber hinaus der Im- und Export von Waren aller Art, soweit sie keiner Einfuhr- oder Ausfuhrbeschränkung unterliegen und soweit keine Genehmigungen erforderlich sind.",127  "meta": {128    "request_credit_cost": 5,129    "credits_remaining": 145130  }131}

200 · Voorbeeldantwoord: de basisgegevens van Hetzner Online GmbH, Ansbach HRB 6089

Naam en rechtsvorm

Naam, rechtsvorm en status beschrijven het bedrijf, de entity_id identificeert het. Sla de entity_id op als je een bedrijf later opnieuw wilt ophalen of bewaken, of het aan je eigen gegevens wilt koppelen.

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
entity_idstring	De ID van het bedrijf bij handelsregister.ai. Sla hem op als sleutel in je gegevens. In de parameter q matcht hij precies dit bedrijf.Basisgegevens	`"94eb910fef13f94585c48c263fa446d4"`	altijd
namestring	Bedrijfsnaam zoals hij in het register staat, met de toevoeging van de rechtsvorm.	`"Hetzner Online GmbH"`	zoals hierboven
legal_formstring	Rechtsvorm, meestal als gangbare Duitse afkorting. Vergelijk zonder op hoofdletters te letten, want de schrijfwijze kan iets variëren, bijvoorbeeld oHG. Met de AI-modus kan de volledige vorm verschijnen. De lijst toont gangbare waarden; er zijn er meer.Waarden: `GmbH` Gesellschaft mit beschränkter Haftung (besloten vennootschap), `UG (haftungsbeschränkt)` Unternehmergesellschaft (mini-GmbH), `AG` Aktiengesellschaft (naamloze vennootschap), `SE` Societas Europaea (Europese vennootschap), `KGaA` Kommanditgesellschaft auf Aktien (commanditaire vennootschap op aandelen), `GmbH & Co. KG` KG met een GmbH als beherend vennoot, `KG` Kommanditgesellschaft (commanditaire vennootschap), `OHG` Offene Handelsgesellschaft (vennootschap onder firma), `e.K.` eingetragener Kaufmann (ingeschreven eenmanszaak), `eG` eingetragene Genossenschaft (ingeschreven coöperatie), `PartG` Partnerschaftsgesellschaft (maatschap van vrije beroepen), ook met beperkte beroepsaansprakelijkheid, `e.V.` eingetragener Verein (ingeschreven vereniging), `eGbR` eingetragene Gesellschaft bürgerlichen Rechts (ingeschreven maatschap)	`"GmbH"`	zoals hierboven
statusstring	Registerstatus van het bedrijf. Andere waarden zijn mogelijk; behandel onbekende waarden als „niet actief”.Waarden: `ACTIVE` actief, `INSOLVENT` in insolventieprocedure, `DISSOLVED` ontbonden, in vereffening, `TERMINATED` uitgeschreven uit het register	`"ACTIVE"`	zoals hierboven

Registerinschrijving

Registerrechtbank, registertype en registernummer identificeren een bedrijf. We schrijven ze samen, in ons voorbeeld als „Ansbach HRB 6089”. In deze vorm kun je ze ook meegeven in de parameter q.

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
registrationobject\|null	De registerinschrijving van het bedrijf.Leeg als de AI-modus een bedrijf alleen uit webbronnen kent; de entity_id begint dan met AI_TMP_Basisgegevens	–	altijd
registration.courtstring	Registerrechtbank als plaatsnaam, zonder „Amtsgericht” (kantongerecht), bijvoorbeeld Ansbach of Charlottenburg (Berlin).	`"Ansbach"`	zoals hierboven
registration.register_typestring	Registertype, dus het register en, bij het Handelsregister, de afdeling.Waarden: `HRB` Handelsregister afdeling B: GmbH, UG, AG, SE, KGaA, `HRA` Handelsregister afdeling A: e.K., OHG, KG, GmbH & Co. KG, `GnR` Genossenschaftsregister (register van coöperaties), `PR` Partnerschaftsregister (register van maatschappen van vrije beroepen), `VR` Vereinsregister (verenigingsregister), `GsR` Gesellschaftsregister (maatschappenregister) voor de eGbR	`"HRB"`	zoals hierboven
registration.register_numberstring	Registernummer als tekst. Alleen samen met registerrechtbank en registertype uniek.	`"6089"`	zoals hierboven
registration_datestring\|null	Datum van inschrijving in het register, als ISO 8601-timestamp.Leeg als de datum niet is vastgelegd	`"2013-03-18T00:00:00+00:00"`	meestal: GmbH, UG, AG, SE, KGaA, KG, OHG, eG, PartG zelden: GmbH & Co. KG, e.K.

Een registernummer is alleen samen met zijn registerrechtbank uniek. Veel rechtbanken kunnen hetzelfde nummer hebben.

Adres en statutaire zetel

address is het bedrijfsadres, seat de statutaire zetel (Sitz) in het register. Die twee kunnen verschillen, bijvoorbeeld als een bedrijf in München is ingeschreven en in Gauting werkt.

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
addressobject	Bedrijfsadres van het bedrijf.Basisgegevens	–	altijd
address.streetstring\|null	Straat zonder huisnummer.Leeg als het adres alleen uit de plaats bestaat	`"Industriestraße"`	meestal
address.house_numberstring\|null	Huisnummer als tekst, ook met een toevoeging zoals „6 a”.Leeg als het adres geen huisnummer heeft	`"25"`	zoals hierboven
address.postal_codestring\|null	Postcode als tekst, zodat voorloopnullen behouden blijven.Leeg als het adres alleen uit de plaats bestaat	`"91710"`	zoals hierboven
address.citystring	Plaats van het bedrijfsadres.	`"Gunzenhausen"`	altijd
address.countystring	District (Landkreis) of kreisfreie stad. Ontbreekt bij sommige adressen als sleutel.	`"Weißenburg-Gunzenhausen"`	meestal
address.statestring	Deelstaat (Bundesland). Ontbreekt bij sommige adressen als sleutel.	`"Bayern"`	zoals hierboven
address.countrystring	Land als drieletterige ISO 3166-code, bijvoorbeeld DEU. Ontbreekt bij sommige adressen als sleutel.	`"DEU"`	zoals hierboven
address.coordinatesobject	Geocoördinaten van het bedrijfsadres, voor kaarten en zoeken in een straal.	–	zoals hierboven
address.coordinates.latitudenumber\|null	Breedtegraad in decimale graden.Leeg als het adres niet kon worden gegeocodeerd	`49.12483`	zoals hierboven
address.coordinates.longitudenumber\|null	Lengtegraad in decimale graden.Leeg als het adres niet kon worden gegeocodeerd	`10.78052`	zoals hierboven
seatobject	De statutaire zetel (Sitz) van het bedrijf in het register.	–	altijd
seat.citystring	Plaats van de statutaire zetel. Kan afwijken van het bedrijfsadres.	`"Gunzenhausen"`	zoals hierboven

Doel van de onderneming en branche

Het doel van de onderneming (Unternehmensgegenstand) staat in het register voor GmbH, UG, AG, SE, KGaA, eG en PartG. GmbH & Co. KG, KG, OHG en eenmanszaken (e.K.) laten geen doel inschrijven. Branche, trefwoorden en producten en diensten zijn er voor elke rechtsvorm.

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
purposestring\|null	Doel van de onderneming zoals het in het register staat, in het Duits. Met de AI-modus is dit een korte samenvatting van de activiteiten, ook bij rechtsvormen zonder ingeschreven doel.Leeg als de rechtsvorm geen doel laat inschrijven, bijvoorbeeld KG, OHG en e.K.Basisgegevens	`"Die Durchführung von Internet- und Netzwerkdienstleistun…"`	altijd: GmbH, UG, AG, SE, KGaA, eG, PartG nooit: GmbH & Co. KG, KG, OHG, e.K.
industry_classificationobject	Branche volgens de Duitse classificatie van economische activiteiten (WZ), in twee versies.	–	altijd
industry_classification.WZ2025array	Branchecodes volgens WZ 2025, de huidige versie. Ook het branchefilter van de zoekfunctie gebruikt deze codes.Leeg als er geen branche kon worden toegewezen	–	meestal
industry_classification.WZ2025[].codestring	Vijfcijferige WZ-code, bijvoorbeeld 62.20.1.	`"62.20.1"`	zoals hierboven
industry_classification.WZ2025[].labelstring	Naam van de economische activiteit, in het Duits.	`"Erbringung von Beratungsleistungen auf dem Gebiet der In…"`	zoals hierboven
industry_classification.WZ2008array	Branchecodes volgens de oudere versie WZ 2008, voor systemen die die nog gebruiken.Leeg als er geen WZ 2008-toewijzing bestaat	–	deels
industry_classification.WZ2008[].codestring	Vijfcijferige WZ-code volgens WZ 2008.	`"62.01.0"`	zoals hierboven
industry_classification.WZ2008[].labelstring	Naam van de economische activiteit, in het Duits.	`"Erbringung von Dienstleistungen der Informationstechnolo…"`	zoals hierboven
keywordsarray	Trefwoorden over de activiteiten van het bedrijf, verzameld uit openbare webbronnen. Uitgebreid met de AI-modus.Leeg als het bedrijf weinig aanwezig is op het web	–	zoals hierboven
products_and_servicesarray	De producten en diensten van het bedrijf als lijst, verzameld uit openbare webbronnen. Uitgebreid met de AI-modus.Leeg als het bedrijf weinig aanwezig is op het web	–	zoals hierboven

Met de AI-modus bevat purpose een korte samenvatting van de activiteiten in plaats van de registertekst. De AI-modus voegt trefwoorden en producten en diensten van het web toe.

Kapitaal

Kapitaalvennootschappen laten hun kapitaal (Stammkapital of Grundkapital, maatschappelijk kapitaal of aandelenkapitaal) inschrijven, elke wijziging met datum. current is het geldende bedrag, history de wijzigingen in chronologische volgorde. Personenvennootschappen en eenmanszaken hebben geen vast kapitaal; daar is current gelijk aan null en is history leeg.

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
capitalobject	Ingeschreven kapitaal met zijn historie.Basisgegevens	–	altijd
capital.currentobject\|null	Het geldende kapitaalbedrag.Leeg als de rechtsvorm geen vast kapitaal laat inschrijven, bijvoorbeeld KG, OHG, e.K. en PartG	–	altijd: GmbH, UG, AG, SE, KGaA zelden: eG nooit: GmbH & Co. KG, KG, OHG, e.K., PartG
capital.current.amountnumber	Bedrag als getal, in de valuta van currency.	`50000`	zoals hierboven
capital.current.currencystring	Valuta als ISO 4217-code, bijna altijd EUR.	`"EUR"`	zoals hierboven
capital.current.kindstring	Soort kapitaal. Andere waarden zijn mogelijk.Waarden: `STAMMKAPITAL` Stammkapital (maatschappelijk kapitaal) van een GmbH of UG, `GRUNDKAPITAL` Grundkapital (aandelenkapitaal) van een AG, SE of KGaA, `LIABILITY_SUM` Haftsumme (aansprakelijkheidsbedrag), bijvoorbeeld van een coöperatie, `CONDITIONAL` voorwaardelijk kapitaal van een AG, in oudere inschrijvingen	`"STAMMKAPITAL"`	zoals hierboven
capital.historyarray	Alle ingeschreven bedragen in chronologische volgorde, inclusief het geldende.	–	zoals hierboven
capital.history[].valueobject	Het bedrag met amount, currency en kind, opgebouwd zoals current.	–	zoals hierboven
capital.history[].value.change_amountobject	Bedrag van de wijziging volgens de registerinschrijving, met amount en currency. Of het kapitaal is verhoogd of verlaagd, volgt uit de vergelijking met het vorige bedrag.	–	deels: AG, SE, KGaA zelden: GmbH, UG, eG nooit: GmbH & Co. KG, KG, OHG, e.K., PartG
capital.history[].effective_fromstring\|null	Geldig vanaf deze dag, in het formaat YYYY-MM-DD.	`"2002-10-15"`	altijd: GmbH, UG, AG, SE, KGaA zelden: eG nooit: GmbH & Co. KG, KG, OHG, e.K., PartG
capital.history[].effective_tostring\|null	Geldig tot deze dag.Leeg als het bedrag nog geldt	`"2005-02-28"`	zoals hierboven

De kapitaalhistorie lezen we automatisch uit de registerinschrijvingen. We gebruiken daarvoor de nieuwste technologie en investeren veel in kwaliteit; afzonderlijke fouten blijven mogelijk.

Vertegenwoordigingsregels

De vertegenwoordigingsregels (Vertretungsregelung) bepalen wie namens het bedrijf mag optreden. Het antwoord bevat ze letterlijk uit het register, in het Duits. In onze voorbeeldaanvraag voor Hetzner Online GmbH noemde de historie tot 28 juli 2015 de raad van bestuur (Vorstand), daarna de bestuurders (Geschäftsführer). De bevoegdheid van afzonderlijke personen staat onder Vertegenwoordigingsbevoegdheid.

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
representation_schemeobject	Algemene vertegenwoordigingsregels van het bedrijf met hun historie.Basisgegevens	–	altijd: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG meestal: AG, SE, KGaA, e.K.
representation_scheme.currentarray\|null	De geldende regels als lijst van tekstalinea’s, letterlijk uit het register.Leeg als er geen regels zijn ingeschreven	–	zoals hierboven
representation_scheme.historyarray	Alle ingeschreven versies met hun geldigheid, inclusief de geldende.	–	zoals hierboven
representation_scheme.history[].valuearray	De tekst van deze versie als lijst van alinea’s.	–	zoals hierboven
representation_scheme.history[].effective_fromstring\|null	Geldig vanaf deze dag, in het formaat YYYY-MM-DD.	`"2002-10-15"`	zoals hierboven
representation_scheme.history[].effective_tostring\|null	Geldig tot deze dag.Leeg als de versie nog geldt	`"2015-07-28"`	zoals hierboven

Met Realtime is history leeg. De geldende versie staat in current.

Contact en web

Contactgegevens staan niet in het register. We verzamelen ze van de website van het bedrijf. Of ze er zijn, hangt dus af van wat het bedrijf op het web publiceert.

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
contact_dataobject	Contactgegevens van de website van het bedrijf.Basisgegevens	–	altijd
contact_data.websitestring\|null	Adres van de website.Leeg als er geen website is gevonden	`"https://www.hetzner.com/"`	deels
contact_data.phone_numberstring\|null	Telefoonnummer zoals het bedrijf het publiceert. Het formaat is niet genormaliseerd.Leeg als er geen nummer is gevonden	`"09831 5050"`	zoals hierboven
contact_data.emailstring\|null	Algemeen e-mailadres van het bedrijf.Leeg als er geen adres is gevonden	`"[email protected]"`	zoals hierboven
website_contentstring\|null	De tekst van de website als Markdown, bijvoorbeeld voor je eigen analyse of een taalmodel. Komt met de feature website_content, alleen samen met de AI-modus en zonder meerprijs.Leeg als er geen website is gevonden`website_content`	`"Dedicated Servers, Cloud & Hosting from Germany \| Hetzne…"`	zoals hierboven

Realtime

Met realtime_mode=handelsregister-default vraagt de API het Handelsregister ook live op. Het antwoord bevat dan de op dat moment ingeschreven personen en _realtime_mode met het resultaat van de opvraging. Realtime wordt alleen berekend als de opvraging slaagt, maar dan ongeacht wat ze oplevert.

Veld
Veld	Betekenis	Voorbeeld	Beschikbaarheid
_realtime_modeobject	Resultaat van de Realtime-opvraging. Alleen in het antwoord als je realtime_mode hebt opgevraagd.Basisgegevens	–	altijd
_realtime_mode.modestring	De gevraagde modus, handelsregister-default.	`"handelsregister-default"`	zoals hierboven
_realtime_mode.statusstring	Of de live-opvraging is geslaagd. Bij elke andere waarde bevat het antwoord de opgeslagen gegevens, en wordt Realtime niet berekend.Waarden: `success` live-opvraging geslaagd, de gegevens komen direct uit het Handelsregister	`"success"`	zoals hierboven

Een Realtime-opvraging duurt langer, stel de timeout van je client dus in op minstens 120 seconden. Mislukt de live-opvraging, dan levert de API de opgeslagen gegevens. _realtime_mode.status is dan niet success, en Realtime wordt niet berekend. Duurt de aanvraag te lang, dan krijg je 408 zonder kosten; probeer het later opnieuw.

Verder

fetch-organization Het endpoint dat de basisgegevens levert, met parameters en fouten. Personen en vertegenwoordiging Bestuurders, Prokura en vennoten met hun bevoegdheden. Basisbegrippen Hoe je actueel en historie, null en lege lijsten leest. Beschikbaarheid van gegevens Wat het register per rechtsvorm bevat en waar de gegevens vandaan komen.