Basdata
Namn, bolagsform, registeranteckning, adress, verksamhetsföremål, kapital och företrädarregler: grunddata i varje företagsprofil.
Basdata beskriver vem ett företag är: namn, bolagsform, registeranteckning, adress, verksamhetsföremål, kapital och företrädarregler. De hör till grunddata och kommer med varje företagsprofil, utan att du begär en funktion.
De flesta fält kommer från Handelsregister (handelsregistret) och de andra officiella registren. Nyckelord, produkter och kontaktuppgifter samlar vi dessutom in från webben. Vad ett företag måste registrera beror på dess bolagsform; kolumnen Tillgänglighet visar det per fält.
Exempel
Exemplen på den här sidan kommer från en exempelförfrågan för Hetzner Online GmbH, Ansbach HRB 6089. Om dess anteckning ändras returnerar din egen förfrågan andra värden.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: DIN_API_NYCKEL" \ --data-urlencode 'q=Hetzner Online GmbH'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "DIN_API_NYCKEL"}, 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_NYCKEL" }, }); 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}
Namn och bolagsform
Namn, bolagsform och status beskriver företaget, entity_id identifierar det. Spara entity_id om du vill hämta eller bevaka ett företag igen senare, eller koppla det till dina egna data.
| Fält | Betydelse | Exempel | Tillgänglighet |
|---|---|---|---|
| entity_idstring | Företagets ID hos handelsregister.ai. Spara det som nyckel i dina data. I parametern q matchar det exakt detta företag.Grunddata |
"94eb910fef13f94585c48c263fa446d4" |
alltid |
| namestring | Företagsnamn så som det står i registret, med bolagsformstillägg. |
"Hetzner Online GmbH" |
som ovan |
| legal_formstring |
Bolagsform, oftast som den vanliga tyska förkortningen. Jämför utan hänsyn till versaler och gemener, eftersom stavningen kan variera något, till exempel oHG. Med AI-läget kan den fullständiga formen förekomma. Listan visar vanliga värden; det finns fler.Värden: GmbH Gesellschaft mit beschränkter Haftung (bolag med begränsat ansvar), UG (haftungsbeschränkt) Unternehmergesellschaft (mini-GmbH), AG Aktiengesellschaft (aktiebolag), SE Societas Europaea (europabolag), KGaA Kommanditgesellschaft auf Aktien (kommanditaktiebolag), GmbH & Co. KG KG med en GmbH som komplementär, KG Kommanditgesellschaft (kommanditbolag), OHG Offene Handelsgesellschaft (handelsbolag), e.K. eingetragener Kaufmann (registrerad enskild näringsidkare), eG eingetragene Genossenschaft (registrerat kooperativ), PartG Partnerschaftsgesellschaft (partnerskapsbolag för fria yrken), även med begränsat yrkesansvar, e.V. eingetragener Verein (registrerad förening), eGbR eingetragene Gesellschaft bürgerlichen Rechts (registrerat civilrättsligt bolag) |
"GmbH" |
som ovan |
| statusstring |
Företagets registerstatus. Andra värden är möjliga; behandla okända värden som ”inte aktivt”.Värden: ACTIVE aktivt, INSOLVENT i insolvensförfarande, DISSOLVED upplöst, i likvidation, TERMINATED avregistrerat ur registret |
"ACTIVE" |
som ovan |
Registeranteckning
Registerdomstol, registertyp och registernummer identifierar ett företag. Vi skriver dem tillsammans, i vårt exempel som ”Ansbach HRB 6089”. I den formen kan du också skicka dem i parametern q.
| Fält | Betydelse | Exempel | Tillgänglighet |
|---|---|---|---|
| registrationobject|null | Företagets registeranteckning.Tomt när AI-läget bara känner till ett företag från webbkällor; dess entity_id börjar då med AI_TMP_Grunddata | – | alltid |
| registration.courtstring | Registerdomstol som ortnamn, utan ”Amtsgericht” (tingsrätt), till exempel Ansbach eller Charlottenburg (Berlin). |
"Ansbach" |
som ovan |
| registration.register_typestring |
Registertyp, alltså registret och, för Handelsregister, dess avdelning.Värden: HRB Handelsregister avdelning B: GmbH, UG, AG, SE, KGaA, HRA Handelsregister avdelning A: e.K., OHG, KG, GmbH & Co. KG, GnR Genossenschaftsregister (kooperativsregistret), PR Partnerschaftsregister (partnerskapsregistret), VR Vereinsregister (föreningsregistret), GsR Gesellschaftsregister (bolagsregistret) för eGbR |
"HRB" |
som ovan |
| registration.register_numberstring | Registernummer som text. Unikt bara tillsammans med registerdomstol och registertyp. |
"6089" |
som ovan |
| registration_datestring|null | Datum för anteckningen i registret, som ISO 8601-tidsstämpel.Tomt när datumet inte är registrerat |
"2013-03-18T00:00:00+00:00" |
oftast: GmbH, UG, AG, SE, KGaA, KG, OHG, eG, PartG sällan: GmbH & Co. KG, e.K. |
Ett registernummer är bara unikt tillsammans med sin registerdomstol. Många domstolar kan ha samma nummer.
Adress och säte
address är affärsadressen, seat det registrerade sätet (Sitz) i registret. De två kan skilja sig åt, till exempel när ett företag är registrerat i München och verkar i Gauting.
| Fält | Betydelse | Exempel | Tillgänglighet |
|---|---|---|---|
| addressobject | Företagets affärsadress.Grunddata | – | alltid |
| address.streetstring|null | Gata utan husnummer.Tomt när adressen bara består av orten |
"Industriestraße" |
oftast |
| address.house_numberstring|null | Husnummer som text, även med tillägg som ”6 a”.Tomt när adressen saknar husnummer |
"25" |
som ovan |
| address.postal_codestring|null | Postnummer som text, så att inledande nollor behålls.Tomt när adressen bara består av orten |
"91710" |
som ovan |
| address.citystring | Ort för affärsadressen. |
"Gunzenhausen" |
alltid |
| address.countystring | Landkreis (distrikt) eller kretsfri stad. Saknas som nyckel i vissa adresser. |
"Weißenburg-Gunzenhausen" |
oftast |
| address.statestring | Delstat (Bundesland). Saknas som nyckel i vissa adresser. |
"Bayern" |
som ovan |
| address.countrystring | Land som trebokstavskod enligt ISO 3166, till exempel DEU. Saknas som nyckel i vissa adresser. |
"DEU" |
som ovan |
| address.coordinatesobject | Geokoordinater för affärsadressen, för kartor och radiesökningar. | – | som ovan |
| address.coordinates.latitudenumber|null | Latitud i decimalgrader.Tomt när adressen inte kunde geokodas |
49.12483 |
som ovan |
| address.coordinates.longitudenumber|null | Longitud i decimalgrader.Tomt när adressen inte kunde geokodas |
10.78052 |
som ovan |
| seatobject | Företagets registrerade säte (Sitz) i registret. | – | alltid |
| seat.citystring | Ort för sätet. Den kan skilja sig från affärsadressen. |
"Gunzenhausen" |
som ovan |
Verksamhetsföremål och bransch
Verksamhetsföremålet (Unternehmensgegenstand) står i registret för GmbH, UG, AG, SE, KGaA, eG och PartG. GmbH & Co. KG, KG, OHG och enskilda näringsidkare (e.K.) registrerar inget verksamhetsföremål. Bransch, nyckelord samt produkter och tjänster finns för varje bolagsform.
| Fält | Betydelse | Exempel | Tillgänglighet |
|---|---|---|---|
| purposestring|null | Verksamhetsföremål så som det står i registret, på tyska. Med AI-läget är det en kort sammanfattning av verksamheten, även för bolagsformer utan registrerat verksamhetsföremål.Tomt när bolagsformen inte registrerar något verksamhetsföremål, till exempel KG, OHG och e.K.Grunddata |
"Die Durchführung von Internet- und Netzwerkdienstleistun…" |
alltid: GmbH, UG, AG, SE, KGaA, eG, PartG aldrig: GmbH & Co. KG, KG, OHG, e.K. |
| industry_classificationobject | Bransch enligt den tyska näringsgrensindelningen (WZ), i två versioner. | – | alltid |
| industry_classification.WZ2025array | Branschkoder enligt WZ 2025, den aktuella versionen. Sökningens branschfilter använder också dessa koder.Tomt när ingen bransch kunde tilldelas | – | oftast |
| industry_classification.WZ2025[].codestring | Femsiffrig WZ-kod, till exempel 62.20.1. |
"62.20.1" |
som ovan |
| industry_classification.WZ2025[].labelstring | Namn på näringsgrenen, på tyska. |
"Erbringung von Beratungsleistungen auf dem Gebiet der In…" |
som ovan |
| industry_classification.WZ2008array | Branschkoder enligt den äldre versionen WZ 2008, för system som fortfarande använder den.Tomt när ingen tilldelning enligt WZ 2008 finns | – | delvis |
| industry_classification.WZ2008[].codestring | Femsiffrig WZ-kod enligt WZ 2008. |
"62.01.0" |
som ovan |
| industry_classification.WZ2008[].labelstring | Namn på näringsgrenen, på tyska. |
"Erbringung von Dienstleistungen der Informationstechnolo…" |
som ovan |
| keywordsarray | Nyckelord om företagets verksamhet, insamlade från offentliga webbkällor. Utökas med AI-läget.Tomt när företaget har liten närvaro på webben | – | som ovan |
| products_and_servicesarray | Företagets produkter och tjänster som lista, insamlade från offentliga webbkällor. Utökas med AI-läget.Tomt när företaget har liten närvaro på webben | – | som ovan |
Med AI-läget innehåller
purpose en kort sammanfattning av verksamheten i stället för registertexten. AI-läget lägger till nyckelord samt produkter och tjänster från webben.
Kapital
Kapitalbolag registrerar sitt aktiekapital (Stammkapital eller Grundkapital), varje ändring med datum. current är det gällande beloppet, history ändringarna i kronologisk ordning. Personbolag och enskilda näringsidkare har inget fast kapital; där är current null och history tom.
| Fält | Betydelse | Exempel | Tillgänglighet |
|---|---|---|---|
| capitalobject | Registrerat kapital med historik.Grunddata | – | alltid |
| capital.currentobject|null | Det gällande kapitalbeloppet.Tomt när bolagsformen inte registrerar något fast kapital, till exempel KG, OHG, e.K. och PartG | – |
alltid: GmbH, UG, AG, SE, KGaA sällan: eG aldrig: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.current.amountnumber | Belopp som tal, i valutan i currency. |
50000 |
som ovan |
| capital.current.currencystring | Valuta som ISO 4217-kod, nästan alltid EUR. |
"EUR" |
som ovan |
| capital.current.kindstring |
Typ av kapital. Andra värden är möjliga.Värden: STAMMKAPITAL Stammkapital (aktiekapital) för en GmbH eller UG, GRUNDKAPITAL Grundkapital (aktiekapital) för ett AG, SE eller KGaA, LIABILITY_SUM Haftsumme (ansvarsbelopp), till exempel för ett kooperativ, CONDITIONAL villkorat kapital för ett AG, i äldre anteckningar |
"STAMMKAPITAL" |
som ovan |
| capital.historyarray | Alla registrerade belopp i kronologisk ordning, inklusive det gällande. | – | som ovan |
| capital.history[].valueobject | Beloppet med amount, currency och kind, uppbyggt som current. | – | som ovan |
| capital.history[].value.change_amountobject | Ändringens belopp enligt registeranteckningen, med amount och currency. Om kapitalet ökades eller minskades framgår av jämförelsen med föregående belopp. | – |
delvis: AG, SE, KGaA sällan: GmbH, UG, eG aldrig: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.history[].effective_fromstring|null | Gäller från denna dag, i formatet YYYY-MM-DD. |
"2002-10-15" |
alltid: GmbH, UG, AG, SE, KGaA sällan: eG aldrig: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.history[].effective_tostring|null | Gäller till denna dag.Tomt när beloppet fortfarande gäller |
"2005-02-28" |
som ovan |
Kapitalhistoriken läser vi automatiskt ur registeranteckningarna. Vi använder den senaste tekniken för detta och investerar mycket i kvalitet; enskilda fel är ändå möjliga.
Företrädarregler
Företrädarreglerna (Vertretungsregelung) bestämmer vem som får agera för företaget. Svaret innehåller dem ordagrant från registret, på tyska. I vår exempelförfrågan för Hetzner Online GmbH nämnde historiken styrelsen (Vorstand) fram till den 28 juli 2015, därefter de verkställande direktörerna. Enskilda personers behörighet finns under Företrädarbehörighet.
| Fält | Betydelse | Exempel | Tillgänglighet |
|---|---|---|---|
| representation_schemeobject | Företagets allmänna företrädarregler med historik.Grunddata | – |
alltid: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG oftast: AG, SE, KGaA, e.K. |
| representation_scheme.currentarray|null | De gällande reglerna som lista med textstycken, ordagrant från registret.Tomt när inga regler är registrerade | – | som ovan |
| representation_scheme.historyarray | Alla registrerade versioner med sin giltighet, inklusive den gällande. | – | som ovan |
| representation_scheme.history[].valuearray | Texten i denna version som lista med stycken. | – | som ovan |
| representation_scheme.history[].effective_fromstring|null | Gäller från denna dag, i formatet YYYY-MM-DD. |
"2002-10-15" |
som ovan |
| representation_scheme.history[].effective_tostring|null | Gäller till denna dag.Tomt när versionen fortfarande gäller |
"2015-07-28" |
som ovan |
Med Realtid är
history tom. Den gällande versionen står i current.
Kontakt och webb
Kontaktuppgifter står inte i registret. Vi samlar in dem från företagets webbplats. Om de finns beror därför på vad företaget publicerar på webben.
| Fält | Betydelse | Exempel | Tillgänglighet |
|---|---|---|---|
| contact_dataobject | Kontaktuppgifter från företagets webbplats.Grunddata | – | alltid |
| contact_data.websitestring|null | Webbplatsens adress.Tomt när ingen webbplats hittades |
"https://www.hetzner.com/" |
delvis |
| contact_data.phone_numberstring|null | Telefonnummer så som företaget publicerar det. Formatet är inte normaliserat.Tomt när inget nummer hittades |
"09831 5050" |
som ovan |
| contact_data.emailstring|null | Företagets allmänna e-postadress.Tomt när ingen adress hittades |
"[email protected]" |
som ovan |
| website_contentstring|null |
Webbplatsens text som Markdown, till exempel för egen analys eller en språkmodell. Kommer med funktionen website_content, bara tillsammans med AI-läget och utan extra kostnad.Tomt när ingen webbplats hittadeswebsite_content |
"Dedicated Servers, Cloud & Hosting from Germany | Hetzne…" |
som ovan |
Realtid
Med realtime_mode=handelsregister-default frågar API:et dessutom Handelsregister live. Svaret innehåller då de personer som är registrerade just nu och _realtime_mode med frågans resultat. Realtid debiteras bara om frågan lyckas, men då oavsett vad den returnerar.
| Fält | Betydelse | Exempel | Tillgänglighet |
|---|---|---|---|
| _realtime_modeobject | Resultat av frågan med Realtid. Finns bara i svaret om du begärde realtime_mode.Grunddata | – | alltid |
| _realtime_mode.modestring | Det begärda läget, handelsregister-default. |
"handelsregister-default" |
som ovan |
| _realtime_mode.statusstring |
Om live-frågan lyckades. Med varje annat värde innehåller svaret sparade data, och Realtid debiteras inte.Värden: success live-frågan lyckades, datan kommer direkt från Handelsregister |
"success" |
som ovan |
En fråga med Realtid tar längre tid, så ställ in din klients timeout på minst 120 sekunder. Om live-frågan misslyckas returnerar API:et sparade data.
_realtime_mode.status är då inte success, och Realtid debiteras inte. Om förfrågan tar för lång tid får du 408 utan kostnad; försök igen senare.
Vidare
fetch-organization
Den endpoint som returnerar basdata, med parametrar och fel.
Personer och företrädare
Verkställande direktörer, Prokura och delägare med sina befogenheter.
Grundbegrepp
Hur du läser current och history, null och tomma listor.
Datatillgänglighet
Vad registret innehåller per bolagsform och var datan kommer ifrån.