Základní údaje
Název, právní forma, zápis v rejstříku, adresa, předmět podnikání, kapitál a způsob zastupování: základní údaje každého profilu firmy.
Základní údaje popisují, kdo firma je: název, právní forma, zápis v rejstříku, adresa, předmět podnikání, kapitál a způsob zastupování. Jsou součástí základních údajů a přicházejí s každým profilem firmy, aniž by sis vyžádal funkci.
Většina polí pochází z Handelsregister (obchodní rejstřík) a dalších úředních rejstříků. Klíčová slova, produkty a kontaktní údaje navíc sbíráme z webu. Co musí firma zapsat, závisí na její právní formě; sloupec Dostupnost to ukazuje pro každé pole.
Příklad
Příklady na této stránce pocházejí z ukázkového požadavku na Hetzner Online GmbH, Ansbach HRB 6089. Pokud se její zápis změní, tvůj vlastní požadavek vrátí jiné hodnoty.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: TVUJ_API_KLIC" \ --data-urlencode 'q=Hetzner Online GmbH'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "TVUJ_API_KLIC"}, 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": "TVUJ_API_KLIC" }, }); 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}
Název a právní forma
Název, právní forma a stav popisují firmu, entity_id ji identifikuje. Ulož si entity_id, pokud chceš firmu později znovu načíst nebo sledovat, nebo ji propojit s vlastními daty.
| Pole | Význam | Příklad | Dostupnost |
|---|---|---|---|
| entity_idstring | ID firmy v handelsregister.ai. Ulož si ho jako klíč ve svých datech. V parametru q odpovídá přesně této firmě.Základní údaje |
"94eb910fef13f94585c48c263fa446d4" |
vždy |
| namestring | Název firmy tak, jak je uveden v rejstříku, s dodatkem právní formy. |
"Hetzner Online GmbH" |
jako výše |
| legal_formstring |
Právní forma, obvykle jako běžná německá zkratka. Porovnávej bez ohledu na velikost písmen, protože zápis se může mírně lišit, například oHG. V AI režimu se může objevit plný název formy. Seznam ukazuje běžné hodnoty; existují i další.Hodnoty: GmbH Gesellschaft mit beschränkter Haftung (společnost s ručením omezeným), UG (haftungsbeschränkt) Unternehmergesellschaft (mini GmbH), AG Aktiengesellschaft (akciová společnost), SE Societas Europaea (evropská společnost), KGaA Kommanditgesellschaft auf Aktien (komanditní společnost na akcie), GmbH & Co. KG KG s GmbH jako komplementářem, KG Kommanditgesellschaft (komanditní společnost), OHG Offene Handelsgesellschaft (veřejná obchodní společnost), e.K. eingetragener Kaufmann (zapsaný kupec, jednotlivec), eG eingetragene Genossenschaft (zapsané družstvo), PartG Partnerschaftsgesellschaft (partnerská společnost svobodných povolání), i s omezeným profesním ručením, e.V. eingetragener Verein (zapsaný spolek), eGbR eingetragene Gesellschaft bürgerlichen Rechts (zapsaná společnost občanského práva) |
"GmbH" |
jako výše |
| statusstring |
Stav firmy v rejstříku. Jiné hodnoty jsou možné; s neznámými hodnotami zacházej jako s „neaktivní“.Hodnoty: ACTIVE aktivní, INSOLVENT v insolvenčním řízení, DISSOLVED zrušená, v likvidaci, TERMINATED vymazaná z rejstříku |
"ACTIVE" |
jako výše |
Zápis v rejstříku
Rejstříkový soud, typ rejstříku a rejstříkové číslo identifikují firmu. Píšeme je dohromady, v našem příkladu jako „Ansbach HRB 6089“. V této podobě je můžeš předat i v parametru q.
| Pole | Význam | Příklad | Dostupnost |
|---|---|---|---|
| registrationobject|null | Zápis firmy v rejstříku.Prázdné, když AI režim zná firmu jen z webových zdrojů; její entity_id pak začíná na AI_TMP_Základní údaje | – | vždy |
| registration.courtstring | Rejstříkový soud jako název místa, bez „Amtsgericht“ (okresní soud), například Ansbach nebo Charlottenburg (Berlin). |
"Ansbach" |
jako výše |
| registration.register_typestring |
Typ rejstříku, tedy rejstřík a u Handelsregister jeho oddělení.Hodnoty: HRB Handelsregister oddělení B: GmbH, UG, AG, SE, KGaA, HRA Handelsregister oddělení A: e.K., OHG, KG, GmbH & Co. KG, GnR Genossenschaftsregister (rejstřík družstev), PR Partnerschaftsregister (rejstřík partnerských společností), VR Vereinsregister (spolkový rejstřík), GsR Gesellschaftsregister (rejstřík společností) pro eGbR |
"HRB" |
jako výše |
| registration.register_numberstring | Rejstříkové číslo jako text. Jednoznačné jen spolu s rejstříkovým soudem a typem rejstříku. |
"6089" |
jako výše |
| registration_datestring|null | Datum zápisu do rejstříku, jako časové razítko ISO 8601.Prázdné, když datum není zaznamenáno |
"2013-03-18T00:00:00+00:00" |
většinou: GmbH, UG, AG, SE, KGaA, KG, OHG, eG, PartG zřídka: GmbH & Co. KG, e.K. |
Rejstříkové číslo je jednoznačné jen spolu se svým rejstříkovým soudem. Stejné číslo může mít mnoho soudů.
Adresa a sídlo
address je obchodní adresa, seat sídlo (Sitz) v rejstříku. Mohou se lišit, například když je firma zapsaná v Mnichově a působí v Gautingu.
| Pole | Význam | Příklad | Dostupnost |
|---|---|---|---|
| addressobject | Obchodní adresa firmy.Základní údaje | – | vždy |
| address.streetstring|null | Ulice bez čísla domu.Prázdné, když adresa sestává jen z města |
"Industriestraße" |
většinou |
| address.house_numberstring|null | Číslo domu jako text, i s dodatkem jako „6 a“.Prázdné, když adresa nemá číslo domu |
"25" |
jako výše |
| address.postal_codestring|null | PSČ jako text, takže úvodní nuly zůstávají.Prázdné, když adresa sestává jen z města |
"91710" |
jako výše |
| address.citystring | Město obchodní adresy. |
"Gunzenhausen" |
vždy |
| address.countystring | Okres (Landkreis) nebo statutární město. U některých adres chybí jako klíč. |
"Weißenburg-Gunzenhausen" |
většinou |
| address.statestring | Spolková země (Bundesland). U některých adres chybí jako klíč. |
"Bayern" |
jako výše |
| address.countrystring | Země jako třípísmenný kód ISO 3166, například DEU. U některých adres chybí jako klíč. |
"DEU" |
jako výše |
| address.coordinatesobject | Zeměpisné souřadnice obchodní adresy, pro mapy a hledání v okruhu. | – | jako výše |
| address.coordinates.latitudenumber|null | Zeměpisná šířka v desetinných stupních.Prázdné, když adresu se nepodařilo geokódovat |
49.12483 |
jako výše |
| address.coordinates.longitudenumber|null | Zeměpisná délka v desetinných stupních.Prázdné, když adresu se nepodařilo geokódovat |
10.78052 |
jako výše |
| seatobject | Sídlo (Sitz) firmy v rejstříku. | – | vždy |
| seat.citystring | Město sídla. Může se lišit od obchodní adresy. |
"Gunzenhausen" |
jako výše |
Předmět podnikání a odvětví
Předmět podnikání (Unternehmensgegenstand) je v rejstříku u GmbH, UG, AG, SE, KGaA, eG a PartG. GmbH & Co. KG, KG, OHG a jednotlivci zapsaní jako kupci (e.K.) předmět podnikání nezapisují. Odvětví, klíčová slova a produkty a služby existují pro každou právní formu.
| Pole | Význam | Příklad | Dostupnost |
|---|---|---|---|
| purposestring|null | Předmět podnikání tak, jak je uveden v rejstříku, německy. V AI režimu jde o krátké shrnutí činnosti, i u právních forem bez zapsaného předmětu podnikání.Prázdné, když právní forma nezapisuje předmět podnikání, například KG, OHG a e.K.Základní údaje |
"Die Durchführung von Internet- und Netzwerkdienstleistun…" |
vždy: GmbH, UG, AG, SE, KGaA, eG, PartG nikdy: GmbH & Co. KG, KG, OHG, e.K. |
| industry_classificationobject | Odvětví podle německé klasifikace ekonomických činností (WZ), ve dvou verzích. | – | vždy |
| industry_classification.WZ2025array | Kódy odvětví podle WZ 2025, aktuální verze. Tyto kódy používá i filtr odvětví ve vyhledávání.Prázdné, když nepodařilo se přiřadit žádné odvětví | – | většinou |
| industry_classification.WZ2025[].codestring | Pětimístný kód WZ, například 62.20.1. |
"62.20.1" |
jako výše |
| industry_classification.WZ2025[].labelstring | Název ekonomické činnosti, německy. |
"Erbringung von Beratungsleistungen auf dem Gebiet der In…" |
jako výše |
| industry_classification.WZ2008array | Kódy odvětví podle starší verze WZ 2008, pro systémy, které ji ještě používají.Prázdné, když neexistuje přiřazení WZ 2008 | – | částečně |
| industry_classification.WZ2008[].codestring | Pětimístný kód WZ podle WZ 2008. |
"62.01.0" |
jako výše |
| industry_classification.WZ2008[].labelstring | Název ekonomické činnosti, německy. |
"Erbringung von Dienstleistungen der Informationstechnolo…" |
jako výše |
| keywordsarray | Klíčová slova k činnosti firmy, sebraná z veřejných webových zdrojů. V AI režimu rozšířená.Prázdné, když firma je na webu málo přítomná | – | jako výše |
| products_and_servicesarray | Produkty a služby firmy jako seznam, sebrané z veřejných webových zdrojů. V AI režimu rozšířené.Prázdné, když firma je na webu málo přítomná | – | jako výše |
V AI režimu obsahuje
purpose místo textu z rejstříku krátké shrnutí činnosti. AI režim doplňuje klíčová slova a produkty a služby z webu.
Kapitál
Kapitálové společnosti zapisují svůj základní kapitál (Stammkapital nebo Grundkapital), každou změnu s datem. current je platná částka, history změny v chronologickém pořadí. Osobní společnosti a jednotlivci zapsaní jako kupci nemají pevný kapitál; tam je current null a history prázdné.
| Pole | Význam | Příklad | Dostupnost |
|---|---|---|---|
| capitalobject | Zapsaný kapitál s historií.Základní údaje | – | vždy |
| capital.currentobject|null | Platná částka kapitálu.Prázdné, když právní forma nezapisuje pevný kapitál, například KG, OHG, e.K. a PartG | – |
vždy: GmbH, UG, AG, SE, KGaA zřídka: eG nikdy: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.current.amountnumber | Částka jako číslo, v měně z currency. |
50000 |
jako výše |
| capital.current.currencystring | Měna jako kód ISO 4217, téměř vždy EUR. |
"EUR" |
jako výše |
| capital.current.kindstring |
Druh kapitálu. Jiné hodnoty jsou možné.Hodnoty: STAMMKAPITAL Stammkapital (základní kapitál) GmbH nebo UG, GRUNDKAPITAL Grundkapital (základní kapitál) AG, SE nebo KGaA, LIABILITY_SUM Haftsumme (výše ručení), například u družstva, CONDITIONAL podmíněný kapitál AG, ve starších zápisech |
"STAMMKAPITAL" |
jako výše |
| capital.historyarray | Všechny zapsané částky v chronologickém pořadí, včetně platné. | – | jako výše |
| capital.history[].valueobject | Částka s amount, currency a kind, strukturovaná jako current. | – | jako výše |
| capital.history[].value.change_amountobject | Výše změny podle zápisu v rejstříku, s amount a currency. Zda byl kapitál zvýšen nebo snížen, vyplývá z porovnání s předchozí částkou. | – |
částečně: AG, SE, KGaA zřídka: GmbH, UG, eG nikdy: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.history[].effective_fromstring|null | Platí od tohoto dne, ve formátu YYYY-MM-DD. |
"2002-10-15" |
vždy: GmbH, UG, AG, SE, KGaA zřídka: eG nikdy: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.history[].effective_tostring|null | Platí do tohoto dne.Prázdné, když částka stále platí |
"2005-02-28" |
jako výše |
Historii kapitálu čteme automaticky ze zápisů v rejstříku. Používáme k tomu nejnovější technologie a hodně investujeme do kvality; jednotlivé chyby přesto nelze vyloučit.
Způsob zastupování
Způsob zastupování (Vertretungsregelung) určuje, kdo smí za firmu jednat. Odpověď ho obsahuje doslovně z rejstříku, německy. V našem ukázkovém požadavku na Hetzner Online GmbH uváděla historie do 28. července 2015 představenstvo (Vorstand), poté jednatele. Oprávnění jednotlivých osob najdeš v části Oprávnění k zastupování.
| Pole | Význam | Příklad | Dostupnost |
|---|---|---|---|
| representation_schemeobject | Obecný způsob zastupování firmy s historií.Základní údaje | – |
vždy: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG většinou: AG, SE, KGaA, e.K. |
| representation_scheme.currentarray|null | Platná pravidla jako seznam textových odstavců, doslovně z rejstříku.Prázdné, když nejsou zapsána žádná pravidla | – | jako výše |
| representation_scheme.historyarray | Všechna zapsaná znění s platností, včetně platného. | – | jako výše |
| representation_scheme.history[].valuearray | Text tohoto znění jako seznam odstavců. | – | jako výše |
| representation_scheme.history[].effective_fromstring|null | Platí od tohoto dne, ve formátu YYYY-MM-DD. |
"2002-10-15" |
jako výše |
| representation_scheme.history[].effective_tostring|null | Platí do tohoto dne.Prázdné, když znění stále platí |
"2015-07-28" |
jako výše |
V režimu v reálném čase je
history prázdné. Platné znění je v current.
Kontakt a web
Kontaktní údaje v rejstříku nejsou. Sbíráme je z webu firmy. Zda existují, proto závisí na tom, co firma na webu zveřejňuje.
| Pole | Význam | Příklad | Dostupnost |
|---|---|---|---|
| contact_dataobject | Kontaktní údaje z webu firmy.Základní údaje | – | vždy |
| contact_data.websitestring|null | Adresa webu.Prázdné, když nebyl nalezen žádný web |
"https://www.hetzner.com/" |
částečně |
| contact_data.phone_numberstring|null | Telefonní číslo tak, jak ho firma zveřejňuje. Formát není normalizovaný.Prázdné, když nebylo nalezeno žádné číslo |
"09831 5050" |
jako výše |
| contact_data.emailstring|null | Obecná e-mailová adresa firmy.Prázdné, když nebyla nalezena žádná adresa |
"[email protected]" |
jako výše |
| website_contentstring|null |
Text webu jako Markdown, například pro vlastní analýzu nebo jazykový model. Přichází s funkcí website_content, jen spolu s AI režimem a bez příplatku.Prázdné, když nebyl nalezen žádný webwebsite_content |
"Dedicated Servers, Cloud & Hosting from Germany | Hetzne…" |
jako výše |
Režim v reálném čase
S realtime_mode=handelsregister-default se API navíc živě dotazuje Handelsregister. Odpověď pak obsahuje aktuálně zapsané osoby a _realtime_mode s výsledkem dotazu. Režim v reálném čase se účtuje jen tehdy, když dotaz uspěje, pak ale bez ohledu na to, co vrátí.
| Pole | Význam | Příklad | Dostupnost |
|---|---|---|---|
| _realtime_modeobject | Výsledek dotazu v reálném čase. V odpovědi jen tehdy, když sis vyžádal realtime_mode.Základní údaje | – | vždy |
| _realtime_mode.modestring | Vyžádaný režim, handelsregister-default. |
"handelsregister-default" |
jako výše |
| _realtime_mode.statusstring |
Zda živý dotaz uspěl. Při jakékoli jiné hodnotě obsahuje odpověď uložená data a režim v reálném čase se neúčtuje.Hodnoty: success živý dotaz uspěl, data pocházejí přímo z Handelsregister |
"success" |
jako výše |
Dotaz v reálném čase trvá déle, nastav proto časový limit svého klienta alespoň na 120 sekund. Pokud živý dotaz selže, API vrátí uložená data.
_realtime_mode.status pak není success a režim v reálném čase se neúčtuje. Pokud požadavek trvá příliš dlouho, dostaneš 408 bez poplatku; zkus to později znovu.