Dokumenter
Hvilke dokumenter der findes, og i hvilket format.
Med fetch-document downloader du officielle dokumenter fra registret som fil. Angiv virksomhedens entity_id i company_id, og vælg en document_type. Hvert leveret dokument koster 15 kreditter.
Dokumenttyper
Der er fem dokumenttyper. Skriv værdierne for document_type præcis som i tabellen, inklusive store og små bogstaver. Eksempelforespørgslen henter Aktueller Abdruck for Hetzner Online GmbH, Ansbach HRB 6089.
| document_type | Dokument | Format |
|---|---|---|
| AD | Aktueller Abdruck (aktuel udskrift)Alle indførsler, der gælder i dag. Det klassiske registerudtræk. | |
| CD | Chronologischer Abdruck (kronologisk udskrift)Alle indførsler i kronologisk rækkefølge, inklusive slettede, siden registret er blevet ført elektronisk. | |
| SI | Strukturierter Registerinhalt (struktureret registerindhold)Registerindholdet som XML i XJustiz-standarden, godt til maskinel behandling. | XML |
| shareholders_list | Gesellschafterliste (ejerliste)Ejerlisten med deres andele, som GmbH’en indleverer den til registret. | |
| articles_of_association | Gesellschaftsvertrag eller Satzung (vedtægter)Den aftale, der regulerer virksomheden. For en GmbH hedder den Gesellschaftsvertrag, for en AG og eG Satzung. |
curl -G "https://handelsregister.ai/api/v1/fetch-document" \ -H "x-api-key: DIN_API_NOEGLE" \ --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": "DIN_API_NOEGLE"}, 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": "DIN_API_NOEGLE" }, }); const data = await response.json();
Dokumenter efter selskabsform
Aktueller Abdruck, Chronologischer Abdruck og Strukturierter Registerinhalt findes for alle registrerede virksomheder. Hvilke indleverede dokumenter der findes derudover, afhænger af selskabsformen.
| Selskabsform | AD, CD, SI | Ejerliste | Vedtægter |
|---|---|---|---|
| GmbH, UG | ja | ja, obligatorisk | ja, Gesellschaftsvertrag |
| AG, SE, KGaA | ja | nej | ja, Satzung |
| eG | ja | nej | ja, Satzung |
| KG, GmbH & Co. KG, OHG | ja | nej | som regel ikke |
| PartG, PartG mbB | ja | nej | som regel ikke |
| e.K. | ja | nej | som regel ikke |
En ejerliste findes kun for GmbH og UG. For andre selskabsformer og manglende dokumenter svarer API’et med 404 og trækker intet.
Formater
Svaret er selve filen, ikke JSON. Typen genkender du på headeren Content-Type, filnavnet på headeren Content-Disposition.
Filnavnet indeholder entity_id, dokumenttypen og hentedatoen, f.eks. document_94eb910fef13f94585c48c263fa446d4_AD_2026-11-01.pdf.
Ejerlister og vedtægter er ofte scannede sider, nogle uden tekstlag. For at få teksten skal du så bruge OCR.
Nogle dokumenter findes kun i registret som TIFF-billede. API’et svarer så med 415 og trækker intet.
I vores eksempel med Hetzner Online GmbH havde filerne disse størrelser: Aktueller Abdruck ca. 35 KB, Strukturierter Registerinhalt ca. 14 KB, Gesellschaftsvertrag ca. 450 KB.
async=true. Svarer registret ikke i tide, får du 504 med Retry-After. Så trækkes der intet.