Pikaopas

Ensimmäinen yritysprofiilisi viidessä minuutissa.

Tarvitset tilin ja päätteen. Lopuksi olet hakenut esimerkkipyynnöllä yrityksen Hetzner Online GmbH yritysprofiilin ja tiedät, mitä vastaus sisältää.

Kopioi API-avaimesi

Luo ilmainen tili ja vahvista sähköpostiosoitteesi. Saat 150 aloituskrediittiä, voimassa 30 päivää.

Ensimmäinen API-avaimesi odottaa sinua jo kohdassa Tili › API-avaimet. Kopioi se ja käsittele sitä kuin salasanaa.

Jokainen pyyntö lähettää avaimen x-api-key-headerissa. Esimerkeissä sen paikalla on YOUR_API_KEY.

Jos API vastaa 401, avain puuttuu tai sitä ei kopioitu kokonaan. Vastauksella 403 sähköpostiosoitettasi ei ole vielä vahvistettu. Vahvistuslinkin löydät saapuneista viesteistäsi.

Hae yritysprofiili

Kutsu päätepistettä fetch-organization ja anna yrityksen nimi parametrissa q. Ilman muita parametreja saat perustiedot 5 krediitillä.

Kopioi pyyntö, lisää avaimesi ja suorita se. cURL tulostaa JSONin suoraan. Pythonissa ja JavaScriptissä vastaus on sen jälkeen muuttujassa data. Komennolla print(data["name"]) tai console.log(data.name) näet yrityksen nimen.

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();

Lue vastaus

Vastaus on yritysprofiili JSONina. Nämä kentät tarvitset useimmin:

Lue vastaus
Kenttä	Merkitys
entity_id	Yrityksen tunniste handelsregister.ai:ssa. Tallenna se jatkopyyntöjä varten.
name, legal_form, status	Toiminimi, yhtiömuoto ja rekisteritila, esimerkissä `ACTIVE`.
registration	Rekisterituomioistuin, rekisterityyppi ja rekisterinumero, esimerkissä Ansbach HRB 6089.
address, seat	Toimipaikan osoite koordinaatteineen sekä rekisterin mukainen kotipaikka.
purpose, industry_classification	Toimiala ja toimialaluokka luokitusten WZ 2008 ja WZ 2025 mukaan.
representation_scheme	Edustussäännöt: `current` on voimassa tänään, `history` näyttää jokaisen rekisteröidyn tilan.
meta	Mitä pyyntö maksoi (`request_credit_cost`) ja saldosi sen jälkeen (`credits_remaining`).

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  "industry_classification": {12    "WZ2008": [13      {14        "code": "62.01.0",15        "label": "Erbringung von Dienstleistungen der Informationstechnologie"16      },17      {18        "code": "63.11.0",19        "label": "Datenverarbeitung, Hosting und damit verbundene Tätigkeiten"20      },21      {22        "code": "61.90.0",23        "label": "Telekommunikation, sonstige"24      }25    ],26    "WZ2025": [27      {28        "code": "62.20.1",29        "label": "Erbringung von Beratungsleistungen auf dem Gebiet der Informationstechnologie"30      },31      {32        "code": "46.50.1",33        "label": "Großhandel mit Datenverarbeitungsgeräten, peripheren Geräten und Software"34      },35      {36        "code": "62.90.0",37        "label": "Erbringung von sonstigen Dienstleistungen der Informationstechnologie"38      }39    ]40  },41  "address": {42    "house_number": "25",43    "street": "Industriestraße",44    "postal_code": "91710",45    "city": "Gunzenhausen",46    "county": "Weißenburg-Gunzenhausen",47    "state": "Bayern",48    "country": "DEU",49    "coordinates": {50      "latitude": 49.12483,51      "longitude": 10.7805252    }53  },54  "seat": {55    "city": "Gunzenhausen"56  },57  "registration_date": null,58  "representation_scheme": {59    "current": [60      "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."61    ],62    "history": [63      {64        "value": [65          "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."66        ],67        "effective_from": "2002-10-15",68        "effective_to": "2015-07-28"69      },70      {71        "value": [72          "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."73        ],74        "effective_from": "2015-07-28",75        "effective_to": null76      }77    ]78  },79  "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.",80  "meta": {81    "request_credit_cost": 5,82    "credits_remaining": 14583  }84}

200 · Esimerkkivastaus yrityksestä Hetzner Online GmbH, vain perustiedot

entity_id:llä haet saman yrityksen myöhemmin suoraan. Se on myös avain päätepisteelle fetch-document ja Signalsille. Rekisterituomioistuin ja rekisterinumero ovat yhtä yksiselitteisiä, esimerkissä Ansbach HRB 6089.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: SINUN_API_AVAIMESI" \
  --data-urlencode 'q=94eb910fef13f94585c48c263fa446d4'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "SINUN_API_AVAIMESI"},
    params={
        "q": "94eb910fef13f94585c48c263fa446d4",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-organization");
url.searchParams.append("q", "94eb910fef13f94585c48c263fa446d4");

const response = await fetch(url, {
  headers: { "x-api-key": "SINUN_API_AVAIMESI" },
});
const data = await response.json();

Mihin seuraavaksi

Lisää ominaisuuksia Toimitusjohtajat, osakkaat tai taloustiedot samassa pyynnössä. Hae yritys rekisterinumerolla Yksiselitteinen tapa rekisterituomioistuimen, rekisterinumeron ja entity_id:n kautta. Peruskäsitteet Miten krediitit, Reaaliaika, historia ja tyhjät arvot toimivat. ChatGPT-plugin Sama data chatissa ilman koodia. Python SDK API Pythonissa valmiine metodeineen. Node SDK API JavaScriptissä ja TypeScriptissä.