Documenten

Welke documenten er zijn en in welk formaat.

Met fetch-document download je officiële documenten uit het register als bestand. Geef de entity_id van het bedrijf mee in company_id en kies een document_type. Elk geleverd document kost 15 credits.

Documenttypen

Er zijn vijf documenttypen. Schrijf de waarden voor document_type precies zoals in de tabel, inclusief hoofd- en kleine letters. De voorbeeldaanvraag haalt de Aktueller Abdruck van Hetzner Online GmbH, Ansbach HRB 6089, op.

document_type
document_type	Document	Formaat
AD	Aktueller Abdruck (actueel uittreksel)Alle inschrijvingen die vandaag gelden. Het klassieke registeruittreksel.	PDF
CD	Chronologischer Abdruck (chronologisch uittreksel)Alle inschrijvingen in chronologische volgorde, ook doorgehaalde, sinds het register elektronisch wordt bijgehouden.	PDF
SI	Strukturierter Registerinhalt (gestructureerde registerinhoud)De registerinhoud als XML in de XJustiz-standaard, geschikt voor machinale verwerking.	XML
shareholders_list	Gesellschafterliste (aandeelhouderslijst)De aandeelhouderslijst met hun aandelen, zoals de GmbH die bij het register indient.	PDF
articles_of_association	Gesellschaftsvertrag of Satzung (statuten)Het contract dat het bedrijf regelt. Bij een GmbH heet het Gesellschaftsvertrag, bij een AG en eG Satzung.	PDF

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

Documenten per rechtsvorm

Aktueller Abdruck, Chronologischer Abdruck en Strukturierter Registerinhalt bestaan voor elk ingeschreven bedrijf. Welke ingediende documenten er daarnaast zijn, hangt af van de rechtsvorm.

Rechtsvorm
Rechtsvorm	AD, CD, SI	Aandeelhouderslijst	Statuten
GmbH, UG	ja	ja, verplicht	ja, het Gesellschaftsvertrag
AG, SE, KGaA	ja	nee	ja, de Satzung
eG	ja	nee	ja, de Satzung
KG, GmbH & Co. KG, OHG	ja	nee	meestal niet
PartG, PartG mbB	ja	nee	meestal niet
e.K.	ja	nee	meestal niet

Een aandeelhouderslijst bestaat alleen voor GmbH en UG. Voor andere rechtsvormen en ontbrekende documenten antwoordt de API met 404 en berekent niets.

Formaten

Het antwoord is het bestand zelf, geen JSON. Het type herken je aan de header Content-Type, de bestandsnaam aan de header Content-Disposition.

De bestandsnaam bevat de entity_id, het documenttype en de datum van ophalen, bijv. document_94eb910fef13f94585c48c263fa446d4_AD_2026-11-01.pdf.

Aandeelhouderslijsten en statuten zijn vaak gescande pagina’s, sommige zonder tekstlaag. Voor de tekst heb je dan OCR nodig.

Sommige documenten zijn in het register alleen als TIFF-afbeelding beschikbaar. De API antwoordt dan met 415 en berekent niets.

In ons voorbeeld van Hetzner Online GmbH hadden de bestanden deze groottes: Aktueller Abdruck ongeveer 35 KB, Strukturierter Registerinhalt ongeveer 14 KB, Gesellschaftsvertrag ongeveer 450 KB.

Documenten halen we wanneer nodig direct uit het register. Dat kan tot twee minuten duren. Stel de timeout van je client dus in op minstens 120 seconden, of haal het document op de achtergrond op met async=true. Antwoordt het register niet op tijd, dan krijg je 504 met Retry-After. Er wordt dan niets berekend.

fetch-document Parameters, antwoord en fouten in detail. Documenten downloaden Stap voor stap naar je eerste document.