Dokumenter

Hvilke dokumenter som finnes, og i hvilket format.

Med fetch-document laster du ned offisielle dokumenter fra registeret som fil. Send firmaets entity_id i company_id og velg en document_type. Hvert levert dokument koster 15 kreditter.

Dokumenttyper

Det finnes fem dokumenttyper. Skriv verdiene for document_type nøyaktig som i tabellen, også med store og små bokstaver. Eksempelforespørselen henter Aktueller Abdruck for Hetzner Online GmbH, Ansbach HRB 6089.

document_type
document_type	Dokument	Format
AD	Aktueller Abdruck (aktuell utskrift)Alle oppføringer som gjelder i dag. Den klassiske registerutskriften.	PDF
CD	Chronologischer Abdruck (kronologisk utskrift)Alle oppføringer i kronologisk rekkefølge, også slettede, siden registeret ble ført elektronisk.	PDF
SI	Strukturierter Registerinhalt (strukturert registerinnhold)Registerinnholdet som XML i XJustiz-standarden, godt egnet for maskinell behandling.	XML
shareholders_list	Gesellschafterliste (eierliste)Eierlisten med andelene deres, slik GmbH-en leverer den til registeret.	PDF
articles_of_association	Gesellschaftsvertrag eller Satzung (vedtekter)Avtalen som styrer firmaet. For en GmbH heter den Gesellschaftsvertrag, for en AG og eG Satzung.	PDF

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

Dokumenter etter selskapsform

Aktueller Abdruck, Chronologischer Abdruck og Strukturierter Registerinhalt finnes for hvert registrert firma. Hvilke innleverte dokumenter som finnes utover det, avhenger av selskapsformen.

Selskapsform
Selskapsform	AD, CD, SI	Eierliste	Vedtekter
GmbH, UG	ja	ja, påkrevd	ja, Gesellschaftsvertrag
AG, SE, KGaA	ja	nei	ja, Satzung
eG	ja	nei	ja, Satzung
KG, GmbH & Co. KG, OHG	ja	nei	som regel ikke
PartG, PartG mbB	ja	nei	som regel ikke
e.K.	ja	nei	som regel ikke

En eierliste finnes bare for GmbH og UG. For andre selskapsformer og manglende dokumenter svarer API-et med 404 og belaster ingenting.

Formater

Svaret er selve filen, ikke JSON. Typen kjenner du igjen på headeren Content-Type, filnavnet på headeren Content-Disposition.

Filnavnet inneholder entity_id, dokumenttypen og hentedatoen, f.eks. document_94eb910fef13f94585c48c263fa446d4_AD_2026-11-01.pdf.

Eierlister og vedtekter er ofte skannede sider, noen uten tekstlag. For å få teksten trenger du da OCR.

Noen dokumenter er bare tilgjengelige fra registeret som TIFF-bilde. API-et svarer da med 415 og belaster ingenting.

I eksempelet vårt med Hetzner Online GmbH hadde filene disse størrelsene: Aktueller Abdruck ca. 35 KB, Strukturierter Registerinhalt ca. 14 KB, Gesellschaftsvertrag ca. 450 KB.

Dokumenter henter vi direkte fra registeret ved behov. Det kan ta opptil to minutter. Sett derfor tidsavbruddet i klienten din til minst 120 sekunder, eller hent dokumentet i bakgrunnen med async=true. Svarer ikke registeret i tide, får du 504 med Retry-After. Ingenting belastes da.

fetch-document Parametere, svar og feil i detalj. Last ned dokumenter Steg for steg til ditt første dokument.