Stamdata
Navn, selskapsform, registeroppføring, adresse, formål, kapital og representasjonsregler: grunndataene i hver firmaprofil.
Stamdataene beskriver hvem et firma er: navn, selskapsform, registeroppføring, adresse, formål, kapital og representasjonsregler. De er en del av grunndataene og følger med hver firmaprofil, uten at du ber om en funksjon.
De fleste feltene kommer fra Handelsregister (handelsregisteret) og de andre offisielle registrene. I tillegg samler vi stikkord, produkter og kontaktdata fra nettet. Hva et firma må registrere, avhenger av selskapsformen; kolonnen Tilgjengelighet viser dette per felt.
Eksempel
Eksemplene på denne siden kommer fra en eksempelforespørsel for Hetzner Online GmbH, Ansbach HRB 6089. Endres oppføringen, returnerer din egen forespørsel andre verdier.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: YOUR_API_KEY" \ --data-urlencode 'q=Hetzner Online GmbH'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "YOUR_API_KEY"}, 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": "YOUR_API_KEY" }, }); 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 selskapsform
Navn, selskapsform og status beskriver firmaet, entity_id identifiserer det. Lagre entity_id hvis du vil hente eller overvåke et firma igjen senere, eller knytte det til dine egne data.
| Felt | Betydning | Eksempel | Tilgjengelighet |
|---|---|---|---|
| entity_idstring | Firmaets ID hos handelsregister.ai. Lagre den som nøkkel i dataene dine. I parameteren q treffer den nøyaktig dette firmaet.Grunndata |
"94eb910fef13f94585c48c263fa446d4" |
alltid |
| namestring | Firmanavn slik det står i registeret, med tillegget for selskapsform. |
"Hetzner Online GmbH" |
som ovenfor |
| legal_formstring |
Selskapsform, som regel som den vanlige tyske forkortelsen. Sammenlign uten hensyn til store og små bokstaver, fordi skrivemåten kan variere litt, for eksempel oHG. Med AI-modus kan den fullstendige formen forekomme. Listen viser vanlige verdier; det finnes flere.Verdier: GmbH Gesellschaft mit beschränkter Haftung (selskap med begrenset ansvar), UG (haftungsbeschränkt) Unternehmergesellschaft (mini-GmbH), AG Aktiengesellschaft (aksjeselskap), SE Societas Europaea (europeisk selskap), KGaA Kommanditgesellschaft auf Aktien (kommandittaksjeselskap), GmbH & Co. KG KG med en GmbH som komplementar, KG Kommanditgesellschaft (kommandittselskap), OHG Offene Handelsgesellschaft (ansvarlig selskap), e.K. eingetragener Kaufmann (registrert enkeltpersonforetak), eG eingetragene Genossenschaft (registrert samvirkeforetak), PartG Partnerschaftsgesellschaft (partnerselskap for frie yrker), også med begrenset profesjonsansvar, e.V. eingetragener Verein (registrert forening), eGbR eingetragene Gesellschaft bürgerlichen Rechts (registrert sivilrettslig selskap) |
"GmbH" |
som ovenfor |
| statusstring |
Firmaets registerstatus. Andre verdier er mulige; behandle ukjente verdier som «ikke aktiv».Verdier: ACTIVE aktiv, INSOLVENT under insolvensbehandling, DISSOLVED oppløst, under avvikling, TERMINATED slettet fra registeret |
"ACTIVE" |
som ovenfor |
Registeroppføring
Registerdomstol, registertype og registernummer identifiserer et firma. Vi skriver dem sammen, i eksempelet vårt som «Ansbach HRB 6089». Du kan også sende dem i denne formen i parameteren q.
| Felt | Betydning | Eksempel | Tilgjengelighet |
|---|---|---|---|
| registrationobject|null | Firmaets registeroppføring.Tom når AI-modus kjenner et firma bare fra nettkilder; entity_id begynner da med AI_TMP_Grunndata | – | alltid |
| registration.courtstring | Registerdomstol som stedsnavn, uten «Amtsgericht» (tingrett), for eksempel Ansbach eller Charlottenburg (Berlin). |
"Ansbach" |
som ovenfor |
| registration.register_typestring |
Registertype, altså registeret og, for Handelsregister, avdelingen.Verdier: HRB Handelsregister avdeling B: GmbH, UG, AG, SE, KGaA, HRA Handelsregister avdeling A: e.K., OHG, KG, GmbH & Co. KG, GnR Genossenschaftsregister (register over samvirkeforetak), PR Partnerschaftsregister (register over partnerselskaper), VR Vereinsregister (foreningsregister), GsR Gesellschaftsregister (selskapsregister) for eGbR |
"HRB" |
som ovenfor |
| registration.register_numberstring | Registernummer som tekst. Bare entydig sammen med registerdomstol og registertype. |
"6089" |
som ovenfor |
| registration_datestring|null | Dato for innføring i registeret, som ISO 8601-tidsstempel.Tom når datoen ikke er registrert |
"2013-03-18T00:00:00+00:00" |
som regel: GmbH, UG, AG, SE, KGaA, KG, OHG, eG, PartG sjelden: GmbH & Co. KG, e.K. |
Et registernummer er bare entydig sammen med registerdomstolen sin. Mange domstoler kan ha det samme nummeret.
Adresse og forretningskontor
address er forretningsadressen, seat forretningskontoret (Sitz) i registeret. De to kan avvike, for eksempel når et firma er registrert i München og holder til i Gauting.
| Felt | Betydning | Eksempel | Tilgjengelighet |
|---|---|---|---|
| addressobject | Firmaets forretningsadresse.Grunndata | – | alltid |
| address.streetstring|null | Gate uten husnummer.Tom når adressen bare består av stedet |
"Industriestraße" |
som regel |
| address.house_numberstring|null | Husnummer som tekst, også med tillegg som «6 a».Tom når adressen ikke har husnummer |
"25" |
som ovenfor |
| address.postal_codestring|null | Postnummer som tekst, så innledende nuller beholdes.Tom når adressen bare består av stedet |
"91710" |
som ovenfor |
| address.citystring | Sted i forretningsadressen. |
"Gunzenhausen" |
alltid |
| address.countystring | Distrikt (Landkreis) eller kretsfri by. Mangler som nøkkel i noen adresser. |
"Weißenburg-Gunzenhausen" |
som regel |
| address.statestring | Delstat (Bundesland). Mangler som nøkkel i noen adresser. |
"Bayern" |
som ovenfor |
| address.countrystring | Land som tre bokstavers ISO 3166-kode, for eksempel DEU. Mangler som nøkkel i noen adresser. |
"DEU" |
som ovenfor |
| address.coordinatesobject | Geokoordinater for forretningsadressen, for kart og radiussøk. | – | som ovenfor |
| address.coordinates.latitudenumber|null | Breddegrad i desimalgrader.Tom når adressen ikke kunne geokodes |
49.12483 |
som ovenfor |
| address.coordinates.longitudenumber|null | Lengdegrad i desimalgrader.Tom når adressen ikke kunne geokodes |
10.78052 |
som ovenfor |
| seatobject | Firmaets forretningskontor (Sitz) i registeret. | – | alltid |
| seat.citystring | Sted for forretningskontoret. Det kan avvike fra forretningsadressen. |
"Gunzenhausen" |
som ovenfor |
Formål og bransje
Formålet (Unternehmensgegenstand) står i registeret for GmbH, UG, AG, SE, KGaA, eG og PartG. GmbH & Co. KG, KG, OHG og enkeltpersonforetak (e.K.) registrerer ikke noe formål. Bransje, stikkord og produkter og tjenester finnes for alle selskapsformer.
| Felt | Betydning | Eksempel | Tilgjengelighet |
|---|---|---|---|
| purposestring|null | Formål slik det står i registeret, på tysk. Med AI-modus er dette et kort sammendrag av virksomheten, også for selskapsformer uten registrert formål.Tom når selskapsformen ikke registrerer noe formål, for eksempel KG, OHG og e.K.Grunndata |
"Die Durchführung von Internet- und Netzwerkdienstleistun…" |
alltid: GmbH, UG, AG, SE, KGaA, eG, PartG aldri: GmbH & Co. KG, KG, OHG, e.K. |
| industry_classificationobject | Bransje etter den tyske klassifiseringen av næringsvirksomhet (WZ), i to versjoner. | – | alltid |
| industry_classification.WZ2025array | Bransjekoder etter WZ 2025, den aktuelle versjonen. Bransjefilteret i søket bruker også disse kodene.Tom når ingen bransje kunne tilordnes | – | som regel |
| industry_classification.WZ2025[].codestring | Femsifret WZ-kode, for eksempel 62.20.1. |
"62.20.1" |
som ovenfor |
| industry_classification.WZ2025[].labelstring | Navnet på næringsvirksomheten, på tysk. |
"Erbringung von Beratungsleistungen auf dem Gebiet der In…" |
som ovenfor |
| industry_classification.WZ2008array | Bransjekoder etter den eldre versjonen WZ 2008, for systemer som fortsatt bruker den.Tom når det ikke finnes noen WZ 2008-tilordning | – | delvis |
| industry_classification.WZ2008[].codestring | Femsifret WZ-kode etter WZ 2008. |
"62.01.0" |
som ovenfor |
| industry_classification.WZ2008[].labelstring | Navnet på næringsvirksomheten, på tysk. |
"Erbringung von Dienstleistungen der Informationstechnolo…" |
som ovenfor |
| keywordsarray | Stikkord om firmaets virksomhet, samlet fra offentlige nettkilder. Utvidet med AI-modus.Tom når firmaet er lite synlig på nettet | – | som ovenfor |
| products_and_servicesarray | Firmaets produkter og tjenester som liste, samlet fra offentlige nettkilder. Utvidet med AI-modus.Tom når firmaet er lite synlig på nettet | – | som ovenfor |
Med AI-modus inneholder
purpose et kort sammendrag av virksomheten i stedet for registerteksten. AI-modus legger til stikkord og produkter og tjenester fra nettet.
Kapital
Kapitalselskaper registrerer aksjekapitalen sin (Stammkapital eller Grundkapital), hver endring med dato. current er beløpet som gjelder, history endringene i kronologisk rekkefølge. Personselskaper og enkeltpersonforetak har ingen fast kapital; der er current null og history tom.
| Felt | Betydning | Eksempel | Tilgjengelighet |
|---|---|---|---|
| capitalobject | Registrert kapital med historikk.Grunndata | – | alltid |
| capital.currentobject|null | Kapitalbeløpet som gjelder.Tom når selskapsformen ikke registrerer noen fast kapital, for eksempel KG, OHG, e.K. og PartG | – |
alltid: GmbH, UG, AG, SE, KGaA sjelden: eG aldri: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.current.amountnumber | Beløp som tall, i valutaen fra currency. |
50000 |
som ovenfor |
| capital.current.currencystring | Valuta som ISO 4217-kode, nesten alltid EUR. |
"EUR" |
som ovenfor |
| capital.current.kindstring |
Kapitaltype. Andre verdier er mulige.Verdier: STAMMKAPITAL Stammkapital (aksjekapital) i en GmbH eller UG, GRUNDKAPITAL Grundkapital (aksjekapital) i en AG, SE eller KGaA, LIABILITY_SUM Haftsumme (ansvarsbeløp), for eksempel i et samvirkeforetak, CONDITIONAL betinget kapital i en AG, i eldre oppføringer |
"STAMMKAPITAL" |
som ovenfor |
| capital.historyarray | Alle registrerte beløp i kronologisk rekkefølge, også det som gjelder. | – | som ovenfor |
| capital.history[].valueobject | Beløpet med amount, currency og kind, bygget opp som current. | – | som ovenfor |
| capital.history[].value.change_amountobject | Endringsbeløpet ifølge registeroppføringen, med amount og currency. Om kapitalen ble økt eller redusert, går frem av sammenligningen med forrige beløp. | – |
delvis: AG, SE, KGaA sjelden: GmbH, UG, eG aldri: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.history[].effective_fromstring|null | Gyldig fra denne dagen, i formatet YYYY-MM-DD. |
"2002-10-15" |
alltid: GmbH, UG, AG, SE, KGaA sjelden: eG aldri: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.history[].effective_tostring|null | Gyldig til denne dagen.Tom når beløpet fortsatt gjelder |
"2005-02-28" |
som ovenfor |
Kapitalhistorikken leser vi automatisk fra registeroppføringene. Vi bruker den nyeste teknologien til dette og investerer mye i kvalitet; enkelte feil er likevel mulige.
Representasjonsregler
Representasjonsreglene (Vertretungsregelung) fastsetter hvem som kan handle for firmaet. Svaret inneholder dem ordrett fra registeret, på tysk. I eksempelforespørselen vår for Hetzner Online GmbH nevnte historikken styret (Vorstand) frem til 28. juli 2015, deretter de daglige lederne. Fullmakten til enkeltpersoner står under Representasjonsrett.
| Felt | Betydning | Eksempel | Tilgjengelighet |
|---|---|---|---|
| representation_schemeobject | Firmaets generelle representasjonsregler med historikk.Grunndata | – |
alltid: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG som regel: AG, SE, KGaA, e.K. |
| representation_scheme.currentarray|null | Reglene som gjelder, som liste med tekstavsnitt, ordrett fra registeret.Tom når ingen regler er registrert | – | som ovenfor |
| representation_scheme.historyarray | Alle registrerte versjoner med gyldighet, også den som gjelder. | – | som ovenfor |
| representation_scheme.history[].valuearray | Teksten i denne versjonen som liste med avsnitt. | – | som ovenfor |
| representation_scheme.history[].effective_fromstring|null | Gyldig fra denne dagen, i formatet YYYY-MM-DD. |
"2002-10-15" |
som ovenfor |
| representation_scheme.history[].effective_tostring|null | Gyldig til denne dagen.Tom når versjonen fortsatt gjelder |
"2015-07-28" |
som ovenfor |
Med Sanntid er
history tom. Versjonen som gjelder, står i current.
Kontakt og nett
Kontaktdata står ikke i registeret. Vi samler dem fra firmaets nettsted. Om de finnes, avhenger derfor av hva firmaet publiserer på nettet.
| Felt | Betydning | Eksempel | Tilgjengelighet |
|---|---|---|---|
| contact_dataobject | Kontaktdata fra firmaets nettsted.Grunndata | – | alltid |
| contact_data.websitestring|null | Adressen til nettstedet.Tom når ikke noe nettsted ble funnet |
"https://www.hetzner.com/" |
delvis |
| contact_data.phone_numberstring|null | Telefonnummer slik firmaet publiserer det. Formatet er ikke normalisert.Tom når ikke noe nummer ble funnet |
"09831 5050" |
som ovenfor |
| contact_data.emailstring|null | Firmaets generelle e-postadresse.Tom når ingen adresse ble funnet |
"[email protected]" |
som ovenfor |
| website_contentstring|null |
Teksten på nettstedet som Markdown, for eksempel for egen analyse eller en språkmodell. Kommer med funksjonen website_content, bare sammen med AI-modus og uten ekstra kostnad.Tom når ikke noe nettsted ble funnetwebsite_content |
"Dedicated Servers, Cloud & Hosting from Germany | Hetzne…" |
som ovenfor |
Sanntid
Med realtime_mode=handelsregister-default spør API-et i tillegg Handelsregister live. Svaret inneholder da personene som er registrert nå, og _realtime_mode med resultatet av spørringen. Sanntid belastes bare hvis spørringen lykkes, men da uansett hva den returnerer.
| Felt | Betydning | Eksempel | Tilgjengelighet |
|---|---|---|---|
| _realtime_modeobject | Resultatet av Sanntid-spørringen. Bare i svaret hvis du ba om realtime_mode.Grunndata | – | alltid |
| _realtime_mode.modestring | Den forespurte modusen, handelsregister-default. |
"handelsregister-default" |
som ovenfor |
| _realtime_mode.statusstring |
Om live-spørringen lyktes. Med enhver annen verdi inneholder svaret de lagrede dataene, og Sanntid belastes ikke.Verdier: success live-spørringen lyktes, dataene kommer rett fra Handelsregister |
"success" |
som ovenfor |
En Sanntid-spørring tar lengre tid, så sett tidsavbruddet i klienten din til minst 120 sekunder. Mislykkes live-spørringen, returnerer API-et de lagrede dataene.
_realtime_mode.status er da ikke success, og Sanntid belastes ikke. Tar forespørselen for lang tid, får du 408 uten kostnad; prøv igjen senere.
Videre
fetch-organization
Endepunktet som returnerer stamdataene, med parametere og feil.
Personer og representasjon
Daglige ledere, Prokura og deltakere med fullmaktene sine.
Grunnbegreper
Hvordan du leser current og history, null og tomme lister.
Datatilgjengelighet
Hva registeret inneholder per selskapsform, og hvor dataene kommer fra.