Perustiedot
Nimi, yhtiömuoto, rekisterimerkintä, osoite, toimiala, pääoma ja edustussäännöt: jokaisen yritysprofiilin perustiedot.
Perustiedot kertovat, kuka yritys on: nimi, yhtiömuoto, rekisterimerkintä, osoite, toimiala, pääoma ja edustussäännöt. Ne kuuluvat perustietoihin ja tulevat jokaisen yritysprofiilin mukana ilman, että pyydät mitään ominaisuutta.
Useimmat kentät tulevat Handelsregisteristä (kaupparekisteri) ja muista virallisista rekistereistä. Lisäksi keräämme verkosta avainsanoja, tuotteita ja yhteystietoja. Mitä yrityksen on rekisteröitävä, riippuu sen yhtiömuodosta; Saatavuus-sarake näyttää tämän kenttäkohtaisesti.
Esimerkki
Tämän sivun esimerkit ovat esimerkkipyynnöstä yrityksestä Hetzner Online GmbH, Ansbach HRB 6089. Jos sen merkintä muuttuu, oma pyyntösi palauttaa eri arvot.
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: SINUN_API_AVAIMESI" \ --data-urlencode 'q=Hetzner Online GmbH'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "SINUN_API_AVAIMESI"}, 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": "SINUN_API_AVAIMESI" }, }); 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}
Nimi ja yhtiömuoto
Nimi, yhtiömuoto ja tila kuvaavat yritystä, entity_id yksilöi sen. Tallenna entity_id, jos haluat hakea tai seurata yritystä myöhemmin uudelleen tai liittää sen omaan dataasi.
| Kenttä | Merkitys | Esimerkki | Saatavuus |
|---|---|---|---|
| entity_idstring | Yrityksen tunniste handelsregister.ai:ssa. Tallenna se datasi avaimeksi. Parametrissa q se osuu täsmälleen tähän yritykseen.Perustiedot |
"94eb910fef13f94585c48c263fa446d4" |
aina |
| namestring | Toiminimi sellaisena kuin se on rekisterissä, yhtiömuodon päätteineen. |
"Hetzner Online GmbH" |
kuten yllä |
| legal_formstring |
Yhtiömuoto, yleensä tavallisena saksalaisena lyhenteenä. Vertaa kirjainkoosta riippumatta, koska kirjoitusasu voi vaihdella hieman, esimerkiksi oHG. AI-tilassa voi esiintyä täysi muoto. Lista näyttää yleiset arvot; niitä on enemmän.Arvot: GmbH Gesellschaft mit beschränkter Haftung (osakeyhtiö), UG (haftungsbeschränkt) Unternehmergesellschaft (”mini-GmbH”), AG Aktiengesellschaft (julkinen osakeyhtiö), SE Societas Europaea (eurooppayhtiö), KGaA Kommanditgesellschaft auf Aktien (osakekommandiittiyhtiö), GmbH & Co. KG KG, jonka vastuunalainen yhtiömies on GmbH, KG Kommanditgesellschaft (kommandiittiyhtiö), OHG Offene Handelsgesellschaft (avoin yhtiö), e.K. eingetragener Kaufmann (rekisteröity elinkeinonharjoittaja), eG eingetragene Genossenschaft (rekisteröity osuuskunta), PartG Partnerschaftsgesellschaft (vapaiden ammattien yhtiö), myös rajoitetulla ammatillisella vastuulla, e.V. eingetragener Verein (rekisteröity yhdistys), eGbR eingetragene Gesellschaft bürgerlichen Rechts (rekisteröity siviilioikeudellinen yhtiö) |
"GmbH" |
kuten yllä |
| statusstring |
Yrityksen rekisteritila. Muutkin arvot ovat mahdollisia; käsittele tuntemattomia arvoja kuin ”ei aktiivinen”.Arvot: ACTIVE aktiivinen, INSOLVENT maksukyvyttömyysmenettelyssä, DISSOLVED purettu, selvitystilassa, TERMINATED poistettu rekisteristä |
"ACTIVE" |
kuten yllä |
Rekisterimerkintä
Rekisterituomioistuin, rekisterityyppi ja rekisterinumero yksilöivät yrityksen. Kirjoitamme ne yhteen, esimerkissämme ”Ansbach HRB 6089”. Voit antaa ne tässä muodossa myös parametrissa q.
| Kenttä | Merkitys | Esimerkki | Saatavuus |
|---|---|---|---|
| registrationobject|null | Yrityksen rekisterimerkintä.Tyhjä, kun AI-tila tuntee yrityksen vain verkkolähteistä; sen entity_id alkaa silloin AI_TMP_Perustiedot | – | aina |
| registration.courtstring | Rekisterituomioistuin paikannimenä ilman sanaa ”Amtsgericht” (alioikeus), esimerkiksi Ansbach tai Charlottenburg (Berlin). |
"Ansbach" |
kuten yllä |
| registration.register_typestring |
Rekisterityyppi eli rekisteri ja Handelsregisterin osalta sen osasto.Arvot: HRB Handelsregister, osasto B: GmbH, UG, AG, SE, KGaA, HRA Handelsregister, osasto A: e.K., OHG, KG, GmbH & Co. KG, GnR Genossenschaftsregister (osuuskuntarekisteri), PR Partnerschaftsregister (vapaiden ammattien yhtiöiden rekisteri), VR Vereinsregister (yhdistysrekisteri), GsR Gesellschaftsregister (yhtiörekisteri) eGbR:lle |
"HRB" |
kuten yllä |
| registration.register_numberstring | Rekisterinumero tekstinä. Yksiselitteinen vain yhdessä rekisterituomioistuimen ja rekisterityypin kanssa. |
"6089" |
kuten yllä |
| registration_datestring|null | Rekisteriin merkitsemisen päivä ISO 8601 -aikaleimana.Tyhjä, kun päivämäärää ei ole kirjattu |
"2013-03-18T00:00:00+00:00" |
yleensä: GmbH, UG, AG, SE, KGaA, KG, OHG, eG, PartG harvoin: GmbH & Co. KG, e.K. |
Rekisterinumero on yksiselitteinen vain yhdessä rekisterituomioistuimensa kanssa. Monella tuomioistuimella voi olla sama numero.
Osoite ja kotipaikka
address on toimipaikan osoite, seat rekisteriin merkitty kotipaikka (Sitz). Ne voivat poiketa toisistaan, esimerkiksi kun yritys on rekisteröity Müncheniin ja toimii Gautingissa.
| Kenttä | Merkitys | Esimerkki | Saatavuus |
|---|---|---|---|
| addressobject | Yrityksen toimipaikan osoite.Perustiedot | – | aina |
| address.streetstring|null | Katu ilman talonumeroa.Tyhjä, kun osoite koostuu vain paikkakunnasta |
"Industriestraße" |
yleensä |
| address.house_numberstring|null | Talonumero tekstinä, myös lisäyksellä kuten ”6 a”.Tyhjä, kun osoitteessa ei ole talonumeroa |
"25" |
kuten yllä |
| address.postal_codestring|null | Postinumero tekstinä, jotta alkunollat säilyvät.Tyhjä, kun osoite koostuu vain paikkakunnasta |
"91710" |
kuten yllä |
| address.citystring | Toimipaikan osoitteen paikkakunta. |
"Gunzenhausen" |
aina |
| address.countystring | Piirikunta (Landkreis) tai piirikuntaan kuulumaton kaupunki. Puuttuu avaimena joistakin osoitteista. |
"Weißenburg-Gunzenhausen" |
yleensä |
| address.statestring | Osavaltio (Bundesland). Puuttuu avaimena joistakin osoitteista. |
"Bayern" |
kuten yllä |
| address.countrystring | Maa kolmikirjaimisena ISO 3166 -koodina, esimerkiksi DEU. Puuttuu avaimena joistakin osoitteista. |
"DEU" |
kuten yllä |
| address.coordinatesobject | Toimipaikan osoitteen maantieteelliset koordinaatit karttoja ja sädehakuja varten. | – | kuten yllä |
| address.coordinates.latitudenumber|null | Leveysaste desimaaliasteina.Tyhjä, kun osoitetta ei voitu geokoodata |
49.12483 |
kuten yllä |
| address.coordinates.longitudenumber|null | Pituusaste desimaaliasteina.Tyhjä, kun osoitetta ei voitu geokoodata |
10.78052 |
kuten yllä |
| seatobject | Yrityksen rekisteriin merkitty kotipaikka (Sitz). | – | aina |
| seat.citystring | Kotipaikan paikkakunta. Se voi poiketa toimipaikan osoitteesta. |
"Gunzenhausen" |
kuten yllä |
Toimiala ja toimialaluokka
Yrityksen toimiala (Unternehmensgegenstand) on rekisterissä yhtiömuodoilla GmbH, UG, AG, SE, KGaA, eG ja PartG. GmbH & Co. KG, KG, OHG ja elinkeinonharjoittajat (e.K.) eivät rekisteröi toimialaa. Toimialaluokka, avainsanat sekä tuotteet ja palvelut ovat saatavilla kaikille yhtiömuodoille.
| Kenttä | Merkitys | Esimerkki | Saatavuus |
|---|---|---|---|
| purposestring|null | Toimiala sellaisena kuin se on rekisterissä, saksaksi. AI-tilassa tämä on lyhyt tiivistelmä liiketoiminnasta, myös yhtiömuodoille, joilla ei ole rekisteröityä toimialaa.Tyhjä, kun yhtiömuoto ei rekisteröi toimialaa, esimerkiksi KG, OHG ja e.K.Perustiedot |
"Die Durchführung von Internet- und Netzwerkdienstleistun…" |
aina: GmbH, UG, AG, SE, KGaA, eG, PartG ei koskaan: GmbH & Co. KG, KG, OHG, e.K. |
| industry_classificationobject | Toimialaluokka Saksan toimialaluokituksen (WZ) mukaan, kahtena versiona. | – | aina |
| industry_classification.WZ2025array | Toimialakoodit WZ 2025:n eli nykyisen version mukaan. Myös haun toimialasuodatin käyttää näitä koodeja.Tyhjä, kun toimialaa ei voitu määrittää | – | yleensä |
| industry_classification.WZ2025[].codestring | Viisinumeroinen WZ-koodi, esimerkiksi 62.20.1. |
"62.20.1" |
kuten yllä |
| industry_classification.WZ2025[].labelstring | Toimialan nimi saksaksi. |
"Erbringung von Beratungsleistungen auf dem Gebiet der In…" |
kuten yllä |
| industry_classification.WZ2008array | Toimialakoodit vanhemman version WZ 2008 mukaan järjestelmille, jotka käyttävät sitä yhä.Tyhjä, kun WZ 2008 -luokitusta ei ole | – | osittain |
| industry_classification.WZ2008[].codestring | Viisinumeroinen WZ-koodi WZ 2008:n mukaan. |
"62.01.0" |
kuten yllä |
| industry_classification.WZ2008[].labelstring | Toimialan nimi saksaksi. |
"Erbringung von Dienstleistungen der Informationstechnolo…" |
kuten yllä |
| keywordsarray | Avainsanoja yrityksen liiketoiminnasta, kerätty julkisista verkkolähteistä. Laajempi AI-tilassa.Tyhjä, kun yrityksellä on vähän näkyvyyttä verkossa | – | kuten yllä |
| products_and_servicesarray | Yrityksen tuotteet ja palvelut listana, kerätty julkisista verkkolähteistä. Laajempi AI-tilassa.Tyhjä, kun yrityksellä on vähän näkyvyyttä verkossa | – | kuten yllä |
AI-tilassa
purpose sisältää rekisteritekstin sijaan lyhyen tiivistelmän liiketoiminnasta. AI-tila lisää verkosta avainsanoja sekä tuotteita ja palveluja.
Pääoma
Pääomayhtiöt rekisteröivät osakepääomansa (Stammkapital tai Grundkapital) ja jokaisen muutoksen päivämäärineen. current on voimassa oleva määrä, history muutokset aikajärjestyksessä. Henkilöyhtiöillä ja elinkeinonharjoittajilla ei ole kiinteää pääomaa; niillä current on null ja history on tyhjä.
| Kenttä | Merkitys | Esimerkki | Saatavuus |
|---|---|---|---|
| capitalobject | Rekisteröity pääoma historioineen.Perustiedot | – | aina |
| capital.currentobject|null | Voimassa oleva pääoman määrä.Tyhjä, kun yhtiömuoto ei rekisteröi kiinteää pääomaa, esimerkiksi KG, OHG, e.K. ja PartG | – |
aina: GmbH, UG, AG, SE, KGaA harvoin: eG ei koskaan: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.current.amountnumber | Määrä lukuna, kentän currency valuutassa. |
50000 |
kuten yllä |
| capital.current.currencystring | Valuutta ISO 4217 -koodina, lähes aina EUR. |
"EUR" |
kuten yllä |
| capital.current.kindstring |
Pääoman laji. Muutkin arvot ovat mahdollisia.Arvot: STAMMKAPITAL GmbH:n tai UG:n Stammkapital (osakepääoma), GRUNDKAPITAL AG:n, SE:n tai KGaA:n Grundkapital (osakepääoma), LIABILITY_SUM Haftsumme (vastuusumma), esimerkiksi osuuskunnan, CONDITIONAL AG:n ehdollinen pääoma, aiemmissa merkinnöissä |
"STAMMKAPITAL" |
kuten yllä |
| capital.historyarray | Kaikki rekisteröidyt määrät aikajärjestyksessä, voimassa oleva mukaan lukien. | – | kuten yllä |
| capital.history[].valueobject | Määrä kentillä amount, currency ja kind, rakenteeltaan kuten current. | – | kuten yllä |
| capital.history[].value.change_amountobject | Muutoksen suuruus rekisterimerkinnän mukaan, kentillä amount ja currency. Korotettiinko vai alennettiinko pääomaa, selviää vertaamalla edelliseen määrään. | – |
osittain: AG, SE, KGaA harvoin: GmbH, UG, eG ei koskaan: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.history[].effective_fromstring|null | Voimassa tästä päivästä alkaen, muodossa YYYY-MM-DD. |
"2002-10-15" |
aina: GmbH, UG, AG, SE, KGaA harvoin: eG ei koskaan: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.history[].effective_tostring|null | Voimassa tähän päivään asti.Tyhjä, kun määrä on yhä voimassa |
"2005-02-28" |
kuten yllä |
Luemme pääomahistorian automaattisesti rekisterimerkinnöistä. Käytämme siihen uusinta tekniikkaa ja panostamme paljon laatuun; yksittäiset virheet ovat silti mahdollisia.
Edustussäännöt
Edustussäännöt (Vertretungsregelung) määräävät, kuka saa toimia yrityksen puolesta. Vastaus sisältää ne sanatarkasti rekisteristä, saksaksi. Esimerkkipyynnössämme yrityksestä Hetzner Online GmbH historia nimesi johtokunnan (Vorstand) 28.7.2015 asti, sen jälkeen toimitusjohtajat. Yksittäisten henkilöiden toimivalta kerrotaan kohdassa Edustusoikeus.
| Kenttä | Merkitys | Esimerkki | Saatavuus |
|---|---|---|---|
| representation_schemeobject | Yrityksen yleiset edustussäännöt historioineen.Perustiedot | – |
aina: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG yleensä: AG, SE, KGaA, e.K. |
| representation_scheme.currentarray|null | Voimassa olevat säännöt tekstikappaleiden listana, sanatarkasti rekisteristä.Tyhjä, kun sääntöjä ei ole rekisteröity | – | kuten yllä |
| representation_scheme.historyarray | Kaikki rekisteröidyt versiot voimassaoloaikoineen, voimassa oleva mukaan lukien. | – | kuten yllä |
| representation_scheme.history[].valuearray | Tämän version teksti kappaleiden listana. | – | kuten yllä |
| representation_scheme.history[].effective_fromstring|null | Voimassa tästä päivästä alkaen, muodossa YYYY-MM-DD. |
"2002-10-15" |
kuten yllä |
| representation_scheme.history[].effective_tostring|null | Voimassa tähän päivään asti.Tyhjä, kun versio on yhä voimassa |
"2015-07-28" |
kuten yllä |
Reaaliajalla
history on tyhjä. Voimassa oleva versio on kentässä current.
Yhteystiedot ja verkko
Yhteystiedot eivät ole rekisterissä. Keräämme ne yrityksen verkkosivuilta. Niiden saatavuus riippuu siis siitä, mitä yritys julkaisee verkossa.
| Kenttä | Merkitys | Esimerkki | Saatavuus |
|---|---|---|---|
| contact_dataobject | Yhteystiedot yrityksen verkkosivuilta.Perustiedot | – | aina |
| contact_data.websitestring|null | Verkkosivujen osoite.Tyhjä, kun verkkosivuja ei löytynyt |
"https://www.hetzner.com/" |
osittain |
| contact_data.phone_numberstring|null | Puhelinnumero siinä muodossa kuin yritys sen julkaisee. Muotoa ei ole yhtenäistetty.Tyhjä, kun numeroa ei löytynyt |
"09831 5050" |
kuten yllä |
| contact_data.emailstring|null | Yrityksen yleinen sähköpostiosoite.Tyhjä, kun osoitetta ei löytynyt |
"[email protected]" |
kuten yllä |
| website_contentstring|null |
Verkkosivujen teksti Markdownina, esimerkiksi omaa analyysiasi tai kielimallia varten. Tulee ominaisuudella website_content, vain yhdessä AI-tilan kanssa ja ilman lisämaksua.Tyhjä, kun verkkosivuja ei löytynytwebsite_content |
"Dedicated Servers, Cloud & Hosting from Germany | Hetzne…" |
kuten yllä |
Reaaliaika
Asetuksella realtime_mode=handelsregister-default API hakee tiedot myös suoraan Handelsregisteristä. Vastauksessa ovat silloin tällä hetkellä rekisteröidyt henkilöt ja _realtime_mode kyselyn tuloksineen. Reaaliaika veloitetaan vain, jos kysely onnistuu, mutta silloin riippumatta siitä, mitä se palauttaa.
| Kenttä | Merkitys | Esimerkki | Saatavuus |
|---|---|---|---|
| _realtime_modeobject | Reaaliaikakyselyn tulos. Vastauksessa vain, jos pyysit parametria realtime_mode.Perustiedot | – | aina |
| _realtime_mode.modestring | Pyydetty tila, handelsregister-default. |
"handelsregister-default" |
kuten yllä |
| _realtime_mode.statusstring |
Onnistuiko suora kysely. Millä tahansa muulla arvolla vastaus sisältää tallennetut tiedot, eikä Reaaliaikaa veloiteta.Arvot: success suora kysely onnistui, data tulee suoraan Handelsregisteristä |
"success" |
kuten yllä |
Reaaliaikakysely kestää kauemmin, joten aseta asiakasohjelmasi aikakatkaisuksi vähintään 120 sekuntia. Jos suora kysely epäonnistuu, API palauttaa tallennetut tiedot.
_realtime_mode.status ei silloin ole success, eikä Reaaliaikaa veloiteta. Jos pyyntö kestää liian kauan, saat maksutta vastauksen 408; yritä myöhemmin uudelleen.
Seuraavaksi
fetch-organization
Päätepiste, joka palauttaa perustiedot, parametreineen ja virheineen.
Henkilöt ja edustus
Toimitusjohtajat, prokura ja yhtiömiehet valtuuksineen.
Peruskäsitteet
Miten luet kentät current ja history, null-arvot ja tyhjät listat.
Datan saatavuus
Mitä rekisteri sisältää yhtiömuodoittain ja mistä data tulee.