Dane podstawowe
Nazwa, forma prawna, wpis do rejestru, adres, przedmiot działalności, kapitał i zasady reprezentacji: dane podstawowe każdego Profilu firmy.
Dane podstawowe opisują, kim jest firma: nazwa, forma prawna, wpis do rejestru, adres, przedmiot działalności, kapitał i zasady reprezentacji. Należą do danych podstawowych i są w każdym profilu firmy, bez zamawiania feature.
Większość pól pochodzi z Handelsregister (rejestr handlowy) i pozostałych rejestrów urzędowych. Słowa kluczowe, produkty i dane kontaktowe zbieramy dodatkowo z sieci. Co firma musi wpisać do rejestru, zależy od jej formy prawnej; kolumna Dostępność pokazuje to dla każdego pola.
Przykład
Przykłady na tej stronie pochodzą z przykładowego zapytania o Hetzner Online GmbH, Ansbach HRB 6089. Jeśli jej wpis się zmieni, twoje zapytanie zwróci inne wartości.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: TWOJ_KLUCZ_API" \ --data-urlencode 'q=Hetzner Online GmbH'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "TWOJ_KLUCZ_API"}, 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": "TWOJ_KLUCZ_API" }, }); 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}
Nazwa i forma prawna
Nazwa, forma prawna i status opisują firmę, entity_id ją identyfikuje. Zapisz entity_id, jeśli chcesz później ponownie pobrać lub monitorować firmę albo powiązać ją z własnymi danymi.
| Pole | Znaczenie | Przykład | Dostępność |
|---|---|---|---|
| entity_idstring | Identyfikator firmy w handelsregister.ai. Zapisz go jako klucz w swoich danych. W parametrze q trafia dokładnie w tę firmę.Dane podstawowe |
"94eb910fef13f94585c48c263fa446d4" |
zawsze |
| namestring | Nazwa firmy, tak jak w rejestrze, z dopiskiem formy prawnej. |
"Hetzner Online GmbH" |
jak wyżej |
| legal_formstring |
Forma prawna, zwykle jako przyjęty niemiecki skrót. Porównuj bez rozróżniania wielkości liter, bo zapis może się nieco różnić, np. oHG. W trybie AI może pojawić się pełna forma. Lista pokazuje częste wartości; jest ich więcej.Wartości: GmbH Gesellschaft mit beschränkter Haftung (spółka z ograniczoną odpowiedzialnością), UG (haftungsbeschränkt) Unternehmergesellschaft (mini-GmbH), AG Aktiengesellschaft (spółka akcyjna), SE Societas Europaea (spółka europejska), KGaA Kommanditgesellschaft auf Aktien (spółka komandytowo-akcyjna), GmbH & Co. KG KG z GmbH jako komplementariuszem, KG Kommanditgesellschaft (spółka komandytowa), OHG Offene Handelsgesellschaft (spółka jawna), e.K. eingetragener Kaufmann (zarejestrowany kupiec jednoosobowy), eG eingetragene Genossenschaft (zarejestrowana spółdzielnia), PartG Partnerschaftsgesellschaft (spółka partnerska), także z ograniczoną odpowiedzialnością zawodową, e.V. eingetragener Verein (zarejestrowane stowarzyszenie), eGbR eingetragene Gesellschaft bürgerlichen Rechts (zarejestrowana spółka prawa cywilnego) |
"GmbH" |
jak wyżej |
| statusstring |
Status firmy w rejestrze. Możliwe są inne wartości; nieznane traktuj jak „nieaktywna”.Wartości: ACTIVE aktywna, INSOLVENT w postępowaniu upadłościowym, DISSOLVED rozwiązana, w likwidacji, TERMINATED wykreślona z rejestru |
"ACTIVE" |
jak wyżej |
Wpis do rejestru
Sąd rejestrowy, typ rejestru i numer rejestru identyfikują firmę. Zapisujemy je razem, w naszym przykładzie jako „Ansbach HRB 6089”. W tej formie możesz je też przekazać w parametrze q.
| Pole | Znaczenie | Przykład | Dostępność |
|---|---|---|---|
| registrationobject|null | Wpis firmy do rejestru.Puste, gdy tryb AI zna firmę tylko ze źródeł w sieci; jej entity_id zaczyna się wtedy od AI_TMP_Dane podstawowe | – | zawsze |
| registration.courtstring | Sąd rejestrowy jako nazwa miejscowości, bez „Amtsgericht” (sąd rejonowy), np. Ansbach lub Charlottenburg (Berlin). |
"Ansbach" |
jak wyżej |
| registration.register_typestring |
Typ rejestru, czyli rejestr, a w Handelsregister jego dział.Wartości: HRB Handelsregister, dział B: GmbH, UG, AG, SE, KGaA, HRA Handelsregister, dział A: e.K., OHG, KG, GmbH & Co. KG, GnR Genossenschaftsregister (rejestr spółdzielni), PR Partnerschaftsregister (rejestr spółek partnerskich), VR Vereinsregister (rejestr stowarzyszeń), GsR Gesellschaftsregister (rejestr spółek) dla eGbR |
"HRB" |
jak wyżej |
| registration.register_numberstring | Numer rejestru jako tekst. Jednoznaczny tylko razem z sądem rejestrowym i typem rejestru. |
"6089" |
jak wyżej |
| registration_datestring|null | Data wpisu do rejestru, jako znacznik czasu ISO 8601.Puste, gdy data nie jest zapisana |
"2013-03-18T00:00:00+00:00" |
zwykle: GmbH, UG, AG, SE, KGaA, KG, OHG, eG, PartG rzadko: GmbH & Co. KG, e.K. |
Numer rejestru jest jednoznaczny tylko razem z sądem rejestrowym. Wiele sądów może mieć ten sam numer.
Adres i siedziba
address to adres firmy, seat to siedziba (Sitz) wpisana w rejestrze. Mogą się różnić, np. gdy firma jest zarejestrowana w Monachium, a działa w Gauting.
| Pole | Znaczenie | Przykład | Dostępność |
|---|---|---|---|
| addressobject | Adres firmy.Dane podstawowe | – | zawsze |
| address.streetstring|null | Ulica bez numeru domu.Puste, gdy adres składa się tylko z miejscowości |
"Industriestraße" |
zwykle |
| address.house_numberstring|null | Numer domu jako tekst, także z dopiskiem, np. „6 a”.Puste, gdy adres nie ma numeru domu |
"25" |
jak wyżej |
| address.postal_codestring|null | Kod pocztowy jako tekst, więc zera na początku zostają.Puste, gdy adres składa się tylko z miejscowości |
"91710" |
jak wyżej |
| address.citystring | Miejscowość adresu firmy. |
"Gunzenhausen" |
zawsze |
| address.countystring | Powiat (Landkreis) lub miasto na prawach powiatu. W niektórych adresach brak tego klucza. |
"Weißenburg-Gunzenhausen" |
zwykle |
| address.statestring | Kraj związkowy (Bundesland). W niektórych adresach brak tego klucza. |
"Bayern" |
jak wyżej |
| address.countrystring | Państwo jako trzyliterowy kod ISO 3166, np. DEU. W niektórych adresach brak tego klucza. |
"DEU" |
jak wyżej |
| address.coordinatesobject | Współrzędne geograficzne adresu firmy, do map i wyszukiwania w promieniu. | – | jak wyżej |
| address.coordinates.latitudenumber|null | Szerokość geograficzna w stopniach dziesiętnych.Puste, gdy adresu nie dało się zgeokodować |
49.12483 |
jak wyżej |
| address.coordinates.longitudenumber|null | Długość geograficzna w stopniach dziesiętnych.Puste, gdy adresu nie dało się zgeokodować |
10.78052 |
jak wyżej |
| seatobject | Siedziba firmy (Sitz) wpisana w rejestrze. | – | zawsze |
| seat.citystring | Miejscowość siedziby. Może się różnić od adresu firmy. |
"Gunzenhausen" |
jak wyżej |
Przedmiot działalności i branża
Przedmiot działalności (Unternehmensgegenstand) jest w rejestrze dla GmbH, UG, AG, SE, KGaA, eG i PartG. GmbH & Co. KG, KG, OHG i kupcy jednoosobowi (e.K.) nie wpisują przedmiotu działalności. Branża, słowa kluczowe oraz produkty i usługi istnieją dla każdej formy prawnej.
| Pole | Znaczenie | Przykład | Dostępność |
|---|---|---|---|
| purposestring|null | Przedmiot działalności, tak jak w rejestrze, po niemiecku. W trybie AI to krótkie podsumowanie działalności, także dla form prawnych bez wpisanego przedmiotu.Puste, gdy forma prawna nie wpisuje przedmiotu działalności, np. KG, OHG i e.K.Dane podstawowe |
"Die Durchführung von Internet- und Netzwerkdienstleistun…" |
zawsze: GmbH, UG, AG, SE, KGaA, eG, PartG nigdy: GmbH & Co. KG, KG, OHG, e.K. |
| industry_classificationobject | Branża według niemieckiej klasyfikacji działalności gospodarczej (WZ), w dwóch wersjach. | – | zawsze |
| industry_classification.WZ2025array | Kody branżowe według WZ 2025, wersji aktualnej. Filtr branży w wyszukiwaniu też używa tych kodów.Puste, gdy nie udało się przypisać branży | – | zwykle |
| industry_classification.WZ2025[].codestring | Pięciocyfrowy kod WZ, np. 62.20.1. |
"62.20.1" |
jak wyżej |
| industry_classification.WZ2025[].labelstring | Nazwa działalności gospodarczej, po niemiecku. |
"Erbringung von Beratungsleistungen auf dem Gebiet der In…" |
jak wyżej |
| industry_classification.WZ2008array | Kody branżowe według starszej wersji WZ 2008, dla systemów, które jej jeszcze używają.Puste, gdy nie ma przypisania WZ 2008 | – | częściowo |
| industry_classification.WZ2008[].codestring | Pięciocyfrowy kod WZ według WZ 2008. |
"62.01.0" |
jak wyżej |
| industry_classification.WZ2008[].labelstring | Nazwa działalności gospodarczej, po niemiecku. |
"Erbringung von Dienstleistungen der Informationstechnolo…" |
jak wyżej |
| keywordsarray | Słowa kluczowe o działalności firmy, zebrane z publicznych źródeł w sieci. Rozszerzone w trybie AI.Puste, gdy firma jest mało obecna w sieci | – | jak wyżej |
| products_and_servicesarray | Produkty i usługi firmy jako lista, zebrane z publicznych źródeł w sieci. Rozszerzone w trybie AI.Puste, gdy firma jest mało obecna w sieci | – | jak wyżej |
W trybie AI
purpose zawiera krótkie podsumowanie działalności zamiast tekstu z rejestru. Tryb AI dodaje słowa kluczowe oraz produkty i usługi z sieci.
Kapitał
Spółki kapitałowe wpisują kapitał zakładowy (Stammkapital lub Grundkapital), każdą zmianę z datą. current to obowiązująca kwota, history zmiany w kolejności chronologicznej. Spółki osobowe i kupcy jednoosobowi nie mają stałego kapitału; tam current ma wartość null, a history jest puste.
| Pole | Znaczenie | Przykład | Dostępność |
|---|---|---|---|
| capitalobject | Wpisany kapitał z historią.Dane podstawowe | – | zawsze |
| capital.currentobject|null | Obowiązująca kwota kapitału.Puste, gdy forma prawna nie wpisuje stałego kapitału, np. KG, OHG, e.K. i PartG | – |
zawsze: GmbH, UG, AG, SE, KGaA rzadko: eG nigdy: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.current.amountnumber | Kwota jako liczba, w walucie z currency. |
50000 |
jak wyżej |
| capital.current.currencystring | Waluta jako kod ISO 4217, prawie zawsze EUR. |
"EUR" |
jak wyżej |
| capital.current.kindstring |
Rodzaj kapitału. Możliwe są inne wartości.Wartości: STAMMKAPITAL Stammkapital (kapitał zakładowy) GmbH lub UG, GRUNDKAPITAL Grundkapital (kapitał zakładowy) AG, SE lub KGaA, LIABILITY_SUM Haftsumme (suma odpowiedzialności), np. spółdzielni, CONDITIONAL kapitał warunkowy AG, we wcześniejszych wpisach |
"STAMMKAPITAL" |
jak wyżej |
| capital.historyarray | Wszystkie wpisane kwoty w kolejności chronologicznej, łącznie z obowiązującą. | – | jak wyżej |
| capital.history[].valueobject | Kwota z amount, currency i kind, w tej samej strukturze co current. | – | jak wyżej |
| capital.history[].value.change_amountobject | Kwota zmiany według wpisu do rejestru, z amount i currency. Czy kapitał podwyższono, czy obniżono, wynika z porównania z poprzednią kwotą. | – |
częściowo: AG, SE, KGaA rzadko: GmbH, UG, eG nigdy: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.history[].effective_fromstring|null | Ważne od tego dnia, w formacie YYYY-MM-DD. |
"2002-10-15" |
zawsze: GmbH, UG, AG, SE, KGaA rzadko: eG nigdy: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.history[].effective_tostring|null | Ważne do tego dnia.Puste, gdy kwota nadal obowiązuje |
"2005-02-28" |
jak wyżej |
Historię kapitału odczytujemy automatycznie z wpisów do rejestru. Używamy do tego najnowszej technologii i dużo inwestujemy w jakość; pojedyncze błędy są jednak możliwe.
Zasady reprezentacji
Zasady reprezentacji (Vertretungsregelung) określają, kto może działać w imieniu firmy. Odpowiedź zawiera je dosłownie z rejestru, po niemiecku. W naszym przykładowym zapytaniu o Hetzner Online GmbH historia wymieniała do 28 lipca 2015 zarząd (Vorstand), a potem członków zarządu (Geschäftsführer). Umocowanie poszczególnych osób opisuje Prawo reprezentacji.
| Pole | Znaczenie | Przykład | Dostępność |
|---|---|---|---|
| representation_schemeobject | Ogólne zasady reprezentacji firmy z historią.Dane podstawowe | – |
zawsze: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG zwykle: AG, SE, KGaA, e.K. |
| representation_scheme.currentarray|null | Obowiązujące zasady jako lista akapitów tekstu, dosłownie z rejestru.Puste, gdy nie wpisano żadnych zasad | – | jak wyżej |
| representation_scheme.historyarray | Wszystkie wpisane wersje z okresem ważności, łącznie z obowiązującą. | – | jak wyżej |
| representation_scheme.history[].valuearray | Tekst tej wersji jako lista akapitów. | – | jak wyżej |
| representation_scheme.history[].effective_fromstring|null | Ważne od tego dnia, w formacie YYYY-MM-DD. |
"2002-10-15" |
jak wyżej |
| representation_scheme.history[].effective_tostring|null | Ważne do tego dnia.Puste, gdy wersja nadal obowiązuje |
"2015-07-28" |
jak wyżej |
W trybie czasu rzeczywistego
history jest puste. Obowiązująca wersja jest w current.
Kontakt i sieć
Danych kontaktowych nie ma w rejestrze. Zbieramy je ze strony internetowej firmy. Czy istnieją, zależy więc od tego, co firma publikuje w sieci.
| Pole | Znaczenie | Przykład | Dostępność |
|---|---|---|---|
| contact_dataobject | Dane kontaktowe ze strony internetowej firmy.Dane podstawowe | – | zawsze |
| contact_data.websitestring|null | Adres strony internetowej.Puste, gdy nie znaleziono strony internetowej |
"https://www.hetzner.com/" |
częściowo |
| contact_data.phone_numberstring|null | Numer telefonu, tak jak publikuje go firma. Format nie jest ujednolicony.Puste, gdy nie znaleziono numeru |
"09831 5050" |
jak wyżej |
| contact_data.emailstring|null | Ogólny adres e-mail firmy.Puste, gdy nie znaleziono adresu |
"[email protected]" |
jak wyżej |
| website_contentstring|null |
Tekst strony internetowej jako Markdown, np. do własnej analizy lub dla modelu językowego. Dostępny z feature website_content, tylko razem z trybem AI i bez dodatkowych kosztów.Puste, gdy nie znaleziono strony internetowejwebsite_content |
"Dedicated Servers, Cloud & Hosting from Germany | Hetzne…" |
jak wyżej |
Tryb czasu rzeczywistego
Z realtime_mode=handelsregister-default API odpytuje dodatkowo Handelsregister na żywo. Odpowiedź zawiera wtedy aktualnie wpisane osoby oraz _realtime_mode z wynikiem zapytania. Tryb czasu rzeczywistego jest naliczany tylko wtedy, gdy zapytanie się powiedzie, ale wtedy niezależnie od tego, co zwróci.
| Pole | Znaczenie | Przykład | Dostępność |
|---|---|---|---|
| _realtime_modeobject | Wynik zapytania w trybie czasu rzeczywistego. Jest w odpowiedzi tylko wtedy, gdy zamówiłeś realtime_mode.Dane podstawowe | – | zawsze |
| _realtime_mode.modestring | Zamówiony tryb, handelsregister-default. |
"handelsregister-default" |
jak wyżej |
| _realtime_mode.statusstring |
Czy zapytanie na żywo się udało. Przy każdej innej wartości odpowiedź zawiera zapisane dane, a tryb czasu rzeczywistego nie jest naliczany.Wartości: success zapytanie na żywo udane, dane pochodzą wprost z Handelsregister |
"success" |
jak wyżej |
Zapytanie w trybie czasu rzeczywistego trwa dłużej, więc ustaw timeout klienta na co najmniej 120 sekund. Jeśli zapytanie na żywo się nie uda, API zwraca zapisane dane.
_realtime_mode.status nie jest wtedy success, a tryb czasu rzeczywistego nie jest naliczany. Jeśli zapytanie trwa za długo, dostajesz 408 bez kosztów; spróbuj ponownie później.
Dalej
fetch-organization
Endpoint, który zwraca dane podstawowe, z parametrami i błędami.
Osoby i reprezentacja
Członkowie zarządu, Prokura i wspólnicy z ich uprawnieniami.
Podstawowe pojęcia
Jak czytać current i history, null i puste listy.
Dostępność danych
Co rejestr zawiera dla każdej formy prawnej i skąd pochodzą dane.