Documente

Ce documente există și în ce format.

Cu fetch-document descarci documente oficiale din registru ca fișier. Transmite entity_id-ul companiei în company_id și alege un document_type. Fiecare document livrat costă 15 credite.

Tipuri de documente

Există cinci tipuri de documente. Scrie valorile pentru document_type exact ca în tabel, inclusiv literele mari și mici. Cererea exemplu preia Aktueller Abdruck al Hetzner Online GmbH, Ansbach HRB 6089.

document_type
document_type	Document	Format
AD	Aktueller Abdruck (extrasul curent)Toate înscrierile valabile azi. Extrasul clasic din registru.	PDF
CD	Chronologischer Abdruck (extrasul cronologic)Toate înscrierile în ordine cronologică, inclusiv cele radiate, de când registrul este ținut electronic.	PDF
SI	Strukturierter Registerinhalt (conținutul structurat al registrului)Conținutul registrului ca XML în standardul XJustiz, potrivit pentru procesare automată.	XML
shareholders_list	Gesellschafterliste (lista asociaților)Lista asociaților cu părțile lor, așa cum o depune GmbH-ul la registru.	PDF
articles_of_association	Gesellschaftsvertrag sau Satzung (actul constitutiv)Contractul care reglementează compania. La un GmbH se numește Gesellschaftsvertrag, la un AG și eG Satzung.	PDF

curl -G "https://handelsregister.ai/api/v1/fetch-document" \
  -H "x-api-key: CHEIA_TA_API" \
  --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": "CHEIA_TA_API"},
    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": "CHEIA_TA_API" },
});
const data = await response.json();

Documente după forma juridică

Aktueller Abdruck, Chronologischer Abdruck și Strukturierter Registerinhalt există pentru orice companie înregistrată. Ce documente depuse mai există în plus depinde de forma juridică.

Formă juridică
Formă juridică	AD, CD, SI	Lista asociaților	Act constitutiv
GmbH, UG	da	da, obligatoriu	da, Gesellschaftsvertrag
AG, SE, KGaA	da	nu	da, Satzung
eG	da	nu	da, Satzung
KG, GmbH & Co. KG, OHG	da	nu	de obicei nu
PartG, PartG mbB	da	nu	de obicei nu
e.K.	da	nu	de obicei nu

O listă a asociaților există doar pentru GmbH și UG. Pentru alte forme juridice și documente lipsă, API-ul răspunde cu 404 și nu taxează nimic.

Formate

Răspunsul este fișierul însuși, nu JSON. Tipul îl recunoști după headerul Content-Type, numele fișierului după headerul Content-Disposition.

Numele fișierului conține entity_id, tipul de document și data preluării, de ex. document_94eb910fef13f94585c48c263fa446d4_AD_2026-11-01.pdf.

Listele asociaților și actele constitutive sunt adesea pagini scanate, unele fără strat de text. Ca să obții textul ai nevoie atunci de OCR.

Unele documente sunt disponibile în registru doar ca imagine TIFF. API-ul răspunde atunci cu 415 și nu taxează nimic.

În exemplul nostru cu Hetzner Online GmbH, fișierele aveau aceste dimensiuni: Aktueller Abdruck circa 35 KB, Strukturierter Registerinhalt circa 14 KB, Gesellschaftsvertrag circa 450 KB.

Preluăm documentele direct din registru la nevoie. Asta poate dura până la două minute. Setează deci timeoutul clientului la cel puțin 120 de secunde sau preia documentul în fundal cu async=true. Dacă registrul nu răspunde la timp, primești 504 cu Retry-After. Nu se taxează atunci nimic.

fetch-document Parametri, răspuns și erori în detaliu. Descarcă documente Pas cu pas până la primul tău document.