Stamdata
Navn, selskabsform, registerindførsel, adresse, formål, kapital og tegningsregler: grunddataene i hver Virksomhedsprofil.
Stamdataene beskriver, hvem en virksomhed er: navn, selskabsform, registerindførsel, adresse, formål, kapital og tegningsregler. De er en del af grunddataene og følger med hver virksomhedsprofil, uden at du skal anmode om en feature.
De fleste felter kommer fra Handelsregister (det tyske handelsregister) og de andre officielle registre. Nøgleord, produkter og kontaktdata samler vi desuden fra nettet. Hvad en virksomhed skal registrere, afhænger af dens selskabsform; kolonnen Tilgængelighed viser det pr. felt.
Eksempel
Eksemplerne på denne side kommer fra en eksempelforespørgsel for Hetzner Online GmbH, Ansbach HRB 6089. Ændres dens indførsel, returnerer din egen forespørgsel andre værdier.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: DIN_API_NOEGLE" \ --data-urlencode 'q=Hetzner Online GmbH'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "DIN_API_NOEGLE"}, 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": "DIN_API_NOEGLE" }, }); 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}
Navn og selskabsform
Navn, selskabsform og status beskriver virksomheden, entity_id identificerer den. Gem entity_id, hvis du vil hente eller overvåge en virksomhed igen senere eller koble den til dine egne data.
| Felt | Betydning | Eksempel | Tilgængelighed |
|---|---|---|---|
| entity_idstring | Virksomhedens ID hos handelsregister.ai. Gem det som nøgle i dine data. I parameteren q matcher det præcis denne virksomhed.Grunddata |
"94eb910fef13f94585c48c263fa446d4" |
altid |
| namestring | Virksomhedens navn, som det står i registret, med selskabsformens tilføjelse. |
"Hetzner Online GmbH" |
som ovenfor |
| legal_formstring |
Selskabsform, som regel som den gængse tyske forkortelse. Sammenlign uden hensyn til store og små bogstaver, for stavemåden kan variere lidt, f.eks. oHG. Med AI-tilstand kan den fulde form optræde. Listen viser almindelige værdier; der findes flere.Værdier: GmbH Gesellschaft mit beschränkter Haftung (anpartsselskab), UG (haftungsbeschränkt) Unternehmergesellschaft (mini-GmbH), AG Aktiengesellschaft (aktieselskab), SE Societas Europaea (europæisk selskab), KGaA Kommanditgesellschaft auf Aktien (kommanditaktieselskab), GmbH & Co. KG KG med en GmbH som komplementar, KG Kommanditgesellschaft (kommanditselskab), OHG Offene Handelsgesellschaft (interessentskab), e.K. eingetragener Kaufmann (registreret enkeltmandsvirksomhed), eG eingetragene Genossenschaft (registreret andelsselskab), PartG Partnerschaftsgesellschaft (partnerselskab for liberale erhverv), også med begrænset erhvervsansvar, e.V. eingetragener Verein (registreret forening), eGbR eingetragene Gesellschaft bürgerlichen Rechts (registreret civilretligt interessentskab) |
"GmbH" |
som ovenfor |
| statusstring |
Virksomhedens registerstatus. Andre værdier er mulige; behandl ukendte værdier som «ikke aktiv».Værdier: ACTIVE aktiv, INSOLVENT under insolvensbehandling, DISSOLVED opløst, under likvidation, TERMINATED slettet fra registret |
"ACTIVE" |
som ovenfor |
Registerindførsel
Registerret, registertype og registernummer identificerer en virksomhed. Vi skriver dem samlet, i vores eksempel som «Ansbach HRB 6089». Du kan også angive dem i denne form i parameteren q.
| Felt | Betydning | Eksempel | Tilgængelighed |
|---|---|---|---|
| registrationobject|null | Virksomhedens registerindførsel.Tom, når AI-tilstand kun kender en virksomhed fra webkilder; dens entity_id starter så med AI_TMP_Grunddata | – | altid |
| registration.courtstring | Registerret som stednavn, uden «Amtsgericht» (byret), f.eks. Ansbach eller Charlottenburg (Berlin). |
"Ansbach" |
som ovenfor |
| registration.register_typestring |
Registertype, dvs. registret og, for Handelsregister, dets afdeling.Værdier: HRB Handelsregister afdeling B: GmbH, UG, AG, SE, KGaA, HRA Handelsregister afdeling A: e.K., OHG, KG, GmbH & Co. KG, GnR Genossenschaftsregister (andelsselskabsregister), PR Partnerschaftsregister (register over partnerselskaber), VR Vereinsregister (foreningsregister), GsR Gesellschaftsregister (selskabsregister) for eGbR |
"HRB" |
som ovenfor |
| registration.register_numberstring | Registernummer som tekst. Kun entydigt sammen med registerret og registertype. |
"6089" |
som ovenfor |
| registration_datestring|null | Dato for indførsel i registret, som ISO 8601-tidsstempel.Tom, når datoen ikke er registreret |
"2013-03-18T00:00:00+00:00" |
oftest: GmbH, UG, AG, SE, KGaA, KG, OHG, eG, PartG sjældent: GmbH & Co. KG, e.K. |
Et registernummer er kun entydigt sammen med sin registerret. Mange retter kan have det samme nummer.
Adresse og hjemsted
address er forretningsadressen, seat det registrerede hjemsted (Sitz) i registret. De to kan afvige fra hinanden, f.eks. når en virksomhed er registreret i München og arbejder i Gauting.
| Felt | Betydning | Eksempel | Tilgængelighed |
|---|---|---|---|
| addressobject | Virksomhedens forretningsadresse.Grunddata | – | altid |
| address.streetstring|null | Gade uden husnummer.Tom, når adressen kun består af byen |
"Industriestraße" |
oftest |
| address.house_numberstring|null | Husnummer som tekst, også med tilføjelse som «6 a».Tom, når adressen ikke har noget husnummer |
"25" |
som ovenfor |
| address.postal_codestring|null | Postnummer som tekst, så foranstillede nuller bevares.Tom, når adressen kun består af byen |
"91710" |
som ovenfor |
| address.citystring | By for forretningsadressen. |
"Gunzenhausen" |
altid |
| address.countystring | Amt (Landkreis) eller amtsfri by. Mangler som nøgle i nogle adresser. |
"Weißenburg-Gunzenhausen" |
oftest |
| address.statestring | Delstat (Bundesland). Mangler som nøgle i nogle adresser. |
"Bayern" |
som ovenfor |
| address.countrystring | Land som ISO 3166-kode på tre bogstaver, f.eks. DEU. Mangler som nøgle i nogle adresser. |
"DEU" |
som ovenfor |
| address.coordinatesobject | Geokoordinater for forretningsadressen, til kort og radiussøgninger. | – | som ovenfor |
| address.coordinates.latitudenumber|null | Breddegrad i decimalgrader.Tom, når adressen ikke kunne geokodes |
49.12483 |
som ovenfor |
| address.coordinates.longitudenumber|null | Længdegrad i decimalgrader.Tom, når adressen ikke kunne geokodes |
10.78052 |
som ovenfor |
| seatobject | Virksomhedens registrerede hjemsted (Sitz) i registret. | – | altid |
| seat.citystring | By for hjemstedet. Den kan afvige fra forretningsadressen. |
"Gunzenhausen" |
som ovenfor |
Formål og branche
Formålet (Unternehmensgegenstand) står i registret for GmbH, UG, AG, SE, KGaA, eG og PartG. GmbH & Co. KG, KG, OHG og enkeltmandsvirksomheder (e.K.) registrerer intet formål. Branche, nøgleord samt produkter og tjenester findes for alle selskabsformer.
| Felt | Betydning | Eksempel | Tilgængelighed |
|---|---|---|---|
| purposestring|null | Formål, som det står i registret, på tysk. Med AI-tilstand er det et kort resumé af forretningen, også for selskabsformer uden registreret formål.Tom, når selskabsformen ikke registrerer noget formål, f.eks. KG, OHG og e.K.Grunddata |
"Die Durchführung von Internet- und Netzwerkdienstleistun…" |
altid: GmbH, UG, AG, SE, KGaA, eG, PartG aldrig: GmbH & Co. KG, KG, OHG, e.K. |
| industry_classificationobject | Branche efter den tyske klassifikation af erhvervsaktiviteter (WZ), i to versioner. | – | altid |
| industry_classification.WZ2025array | Branchekoder efter WZ 2025, den aktuelle version. Søgningens branchefilter bruger også disse koder.Tom, når der ikke kunne tildeles nogen branche | – | oftest |
| industry_classification.WZ2025[].codestring | Femcifret WZ-kode, f.eks. 62.20.1. |
"62.20.1" |
som ovenfor |
| industry_classification.WZ2025[].labelstring | Betegnelse for erhvervsaktiviteten, på tysk. |
"Erbringung von Beratungsleistungen auf dem Gebiet der In…" |
som ovenfor |
| industry_classification.WZ2008array | Branchekoder efter den ældre version WZ 2008, til systemer der stadig bruger den.Tom, når der ikke findes nogen WZ 2008-tildeling | – | delvist |
| industry_classification.WZ2008[].codestring | Femcifret WZ-kode efter WZ 2008. |
"62.01.0" |
som ovenfor |
| industry_classification.WZ2008[].labelstring | Betegnelse for erhvervsaktiviteten, på tysk. |
"Erbringung von Dienstleistungen der Informationstechnolo…" |
som ovenfor |
| keywordsarray | Nøgleord om virksomhedens forretning, samlet fra offentlige webkilder. Udvides med AI-tilstand.Tom, når virksomheden er kun lidt til stede på nettet | – | som ovenfor |
| products_and_servicesarray | Virksomhedens produkter og tjenester som liste, samlet fra offentlige webkilder. Udvides med AI-tilstand.Tom, når virksomheden er kun lidt til stede på nettet | – | som ovenfor |
Med AI-tilstand indeholder
purpose et kort resumé af forretningen i stedet for registerteksten. AI-tilstand tilføjer nøgleord samt produkter og tjenester fra nettet.
Kapital
Kapitalselskaber registrerer deres kapital (Stammkapital eller Grundkapital), hver ændring med dato. current er det gældende beløb, history ændringerne i kronologisk rækkefølge. Personselskaber og enkeltmandsvirksomheder har ingen fast kapital; dér er current null, og history er tom.
| Felt | Betydning | Eksempel | Tilgængelighed |
|---|---|---|---|
| capitalobject | Registreret kapital med historik.Grunddata | – | altid |
| capital.currentobject|null | Det gældende kapitalbeløb.Tom, når selskabsformen ikke registrerer nogen fast kapital, f.eks. KG, OHG, e.K. og PartG | – |
altid: GmbH, UG, AG, SE, KGaA sjældent: eG aldrig: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.current.amountnumber | Beløb som tal, i valutaen fra currency. |
50000 |
som ovenfor |
| capital.current.currencystring | Valuta som ISO 4217-kode, næsten altid EUR. |
"EUR" |
som ovenfor |
| capital.current.kindstring |
Kapitaltype. Andre værdier er mulige.Værdier: STAMMKAPITAL Stammkapital (selskabskapital) for en GmbH eller UG, GRUNDKAPITAL Grundkapital (aktiekapital) for en AG, SE eller KGaA, LIABILITY_SUM Haftsumme (hæftelsesbeløb), f.eks. for et andelsselskab, CONDITIONAL betinget kapital for en AG, i tidligere indførsler |
"STAMMKAPITAL" |
som ovenfor |
| capital.historyarray | Alle registrerede beløb i kronologisk rækkefølge, inklusive det gældende. | – | som ovenfor |
| capital.history[].valueobject | Beløbet med amount, currency og kind, struktureret som current. | – | som ovenfor |
| capital.history[].value.change_amountobject | Ændringens beløb ifølge registerindførslen, med amount og currency. Om kapitalen blev forhøjet eller nedsat, fremgår af sammenligningen med det forrige beløb. | – |
delvist: AG, SE, KGaA sjældent: GmbH, UG, eG aldrig: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.history[].effective_fromstring|null | Gyldig fra denne dag, i formatet YYYY-MM-DD. |
"2002-10-15" |
altid: GmbH, UG, AG, SE, KGaA sjældent: eG aldrig: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.history[].effective_tostring|null | Gyldig til denne dag.Tom, når beløbet stadig gælder |
"2005-02-28" |
som ovenfor |
Kapitalhistorikken læser vi automatisk ud af registerindførslerne. Vi bruger den nyeste teknologi til det og investerer meget i kvalitet; enkelte fejl er stadig mulige.
Tegningsregler
Tegningsreglerne (Vertretungsregelung) fastlægger, hvem der må handle for virksomheden. Svaret indeholder dem ordret fra registret, på tysk. I vores eksempelforespørgsel for Hetzner Online GmbH nævnte historikken direktionen (Vorstand) indtil 28. juli 2015, derefter direktørerne. Enkeltpersoners beføjelser står under Tegningsret.
| Felt | Betydning | Eksempel | Tilgængelighed |
|---|---|---|---|
| representation_schemeobject | Virksomhedens generelle tegningsregler med historik.Grunddata | – |
altid: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG oftest: AG, SE, KGaA, e.K. |
| representation_scheme.currentarray|null | De gældende regler som liste af tekstafsnit, ordret fra registret.Tom, når der ikke er registreret nogen regler | – | som ovenfor |
| representation_scheme.historyarray | Alle registrerede versioner med deres gyldighed, inklusive den gældende. | – | som ovenfor |
| representation_scheme.history[].valuearray | Teksten i denne version som liste af afsnit. | – | som ovenfor |
| representation_scheme.history[].effective_fromstring|null | Gyldig fra denne dag, i formatet YYYY-MM-DD. |
"2002-10-15" |
som ovenfor |
| representation_scheme.history[].effective_tostring|null | Gyldig til denne dag.Tom, når versionen stadig gælder |
"2015-07-28" |
som ovenfor |
Med Realtid er
history tom. Den gældende version står i current.
Kontakt og web
Kontaktdata står ikke i registret. Vi samler dem fra virksomhedens hjemmeside. Om de findes, afhænger derfor af, hvad virksomheden offentliggør på nettet.
| Felt | Betydning | Eksempel | Tilgængelighed |
|---|---|---|---|
| contact_dataobject | Kontaktdata fra virksomhedens hjemmeside.Grunddata | – | altid |
| contact_data.websitestring|null | Hjemmesidens adresse.Tom, når der ikke blev fundet nogen hjemmeside |
"https://www.hetzner.com/" |
delvist |
| contact_data.phone_numberstring|null | Telefonnummer, som virksomheden offentliggør det. Formatet er ikke normaliseret.Tom, når der ikke blev fundet noget nummer |
"09831 5050" |
som ovenfor |
| contact_data.emailstring|null | Virksomhedens generelle e-mailadresse.Tom, når der ikke blev fundet nogen adresse |
"[email protected]" |
som ovenfor |
| website_contentstring|null |
Hjemmesidens tekst som Markdown, f.eks. til din egen analyse eller en sprogmodel. Følger med featuren website_content, kun sammen med AI-tilstand og uden ekstra omkostninger.Tom, når der ikke blev fundet nogen hjemmesidewebsite_content |
"Dedicated Servers, Cloud & Hosting from Germany | Hetzne…" |
som ovenfor |
Realtid
Med realtime_mode=handelsregister-default forespørger API’et også Handelsregister live. Svaret indeholder så de aktuelt registrerede personer og _realtime_mode med resultatet af forespørgslen. Realtid afregnes kun, hvis forespørgslen lykkes, men så uanset hvad den returnerer.
| Felt | Betydning | Eksempel | Tilgængelighed |
|---|---|---|---|
| _realtime_modeobject | Resultatet af Realtid-forespørgslen. Kun i svaret, hvis du har anmodet om realtime_mode.Grunddata | – | altid |
| _realtime_mode.modestring | Den ønskede tilstand, handelsregister-default. |
"handelsregister-default" |
som ovenfor |
| _realtime_mode.statusstring |
Om live-forespørgslen lykkedes. Ved enhver anden værdi indeholder svaret de gemte data, og Realtid afregnes ikke.Værdier: success live-forespørgslen lykkedes, dataene kommer direkte fra Handelsregister |
"success" |
som ovenfor |
En Realtid-forespørgsel tager længere tid, så sæt din klients timeout til mindst 120 sekunder. Fejler live-forespørgslen, returnerer API’et de gemte data.
_realtime_mode.status er så ikke success, og Realtid afregnes ikke. Tager forespørgslen for lang tid, får du 408 uden omkostninger; prøv igen senere.
Videre
fetch-organization
Endpointet, der returnerer stamdataene, med parametre og fejl.
Personer og tegning
Direktører, prokura og interessenter med deres beføjelser.
Grundbegreber
Sådan læser du current og history, null og tomme lister.
Datatilgængelighed
Hvad registret indeholder pr. selskabsform, og hvor dataene kommer fra.