Asiakirjat

Mitä asiakirjoja on ja missä muodossa.

Päätepisteellä fetch-document lataat virallisia asiakirjoja rekisteristä tiedostona. Anna yrityksen entity_id parametrissa company_id ja valitse document_type. Jokainen toimitettu asiakirja maksaa 15 krediittiä.

Asiakirjatyypit

Asiakirjatyyppejä on viisi. Kirjoita parametrin document_type arvot täsmälleen kuten taulukossa, isot ja pienet kirjaimet mukaan lukien. Esimerkkipyyntö hakee yrityksen Hetzner Online GmbH, Ansbach HRB 6089, Aktueller Abdruckin.

document_type
document_type	Asiakirja	Muoto
AD	Aktueller Abdruck (ajantasainen ote)Kaikki tänään voimassa olevat merkinnät. Klassinen kaupparekisteriote.	PDF
CD	Chronologischer Abdruck (kronologinen ote)Kaikki merkinnät aikajärjestyksessä, poistetut mukaan lukien, siitä lähtien kun rekisteriä on pidetty sähköisesti.	PDF
SI	Strukturierter Registerinhalt (jäsennelty rekisterisisältö)Rekisterisisältö XML-muodossa XJustiz-standardin mukaan, sopii koneelliseen käsittelyyn.	XML
shareholders_list	Gesellschafterliste (osakasluettelo)Osakasluettelo osuuksineen sellaisena kuin GmbH sen toimittaa rekisteriin.	PDF
articles_of_association	Gesellschaftsvertrag tai Satzung (yhtiöjärjestys)Yritystä sääntelevä sopimus. GmbH:lla sen nimi on Gesellschaftsvertrag, AG:lla ja eG:llä Satzung.	PDF

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

import requests

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

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

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

Asiakirjat yhtiömuodoittain

Aktueller Abdruck, Chronologischer Abdruck ja Strukturierter Registerinhalt ovat saatavilla jokaisesta rekisteröidystä yrityksestä. Mitä toimitettuja asiakirjoja sen lisäksi on, riippuu yhtiömuodosta.

Yhtiömuoto
Yhtiömuoto	AD, CD, SI	Osakasluettelo	Yhtiöjärjestys
GmbH, UG	kyllä	kyllä, pakollinen	kyllä, Gesellschaftsvertrag
AG, SE, KGaA	kyllä	ei	kyllä, Satzung
eG	kyllä	ei	kyllä, Satzung
KG, GmbH & Co. KG, OHG	kyllä	ei	yleensä ei
PartG, PartG mbB	kyllä	ei	yleensä ei
e.K.	kyllä	ei	yleensä ei

Osakasluettelo on olemassa vain GmbH:lle ja UG:lle. Muiden yhtiömuotojen ja puuttuvien asiakirjojen kohdalla API vastaa 404 eikä veloita mitään.

Muodot

Vastaus on itse tiedosto, ei JSON. Tyypin tunnistat Content-Type-headerista, tiedostonimen Content-Disposition-headerista.

Tiedostonimi sisältää entity_id:n, asiakirjatyypin ja hakupäivän, esim. document_94eb910fef13f94585c48c263fa446d4_AD_2026-11-01.pdf.

Osakasluettelot ja yhtiöjärjestykset ovat usein skannattuja sivuja, osa ilman tekstikerrosta. Tekstin saamiseksi tarvitset silloin OCR:n.

Jotkin asiakirjat ovat rekisterissä saatavilla vain TIFF-kuvana. API vastaa silloin 415 eikä veloita mitään.

Esimerkissämme yrityksestä Hetzner Online GmbH tiedostojen koot olivat: Aktueller Abdruck noin 35 KB, Strukturierter Registerinhalt noin 14 KB, Gesellschaftsvertrag noin 450 KB.

Haemme asiakirjat tarvittaessa suoraan rekisteristä. Se voi kestää jopa kaksi minuuttia. Aseta siis asiakasohjelmasi aikakatkaisuksi vähintään 120 sekuntia tai hae asiakirja taustalla asetuksella async=true. Jos rekisteri ei vastaa ajoissa, saat vastauksen 504 ja headerin Retry-After. Silloin mitään ei veloiteta.

fetch-document Parametrit, vastaus ja virheet yksityiskohtaisesti. Lataa asiakirjoja Vaihe vaiheelta ensimmäiseen asiakirjaasi.