Documenti
Quali documenti esistono e in quale formato.
Con fetch-document scarichi documenti ufficiali dal registro come file. Passa l’entity_id dell’azienda in company_id e scegli un document_type. Ogni documento consegnato costa 15 crediti.
Tipi di documento
Ci sono cinque tipi di documento. Scrivi i valori per document_type esattamente come nella tabella, maiuscole e minuscole comprese. La richiesta di esempio recupera l’Aktueller Abdruck di Hetzner Online GmbH, Ansbach HRB 6089.
| document_type | Documento | Formato |
|---|---|---|
| AD | Aktueller Abdruck (estratto attuale)Tutte le iscrizioni valide oggi. Il classico estratto del registro. | |
| CD | Chronologischer Abdruck (estratto cronologico)Tutte le iscrizioni in ordine cronologico, comprese quelle cancellate, da quando il registro è tenuto in forma elettronica. | |
| SI | Strukturierter Registerinhalt (contenuto strutturato del registro)Il contenuto del registro come XML nello standard XJustiz, adatto all’elaborazione automatica. | XML |
| shareholders_list | Gesellschafterliste (elenco soci)L’elenco dei soci con le loro quote, come la GmbH lo deposita presso il registro. | |
| articles_of_association | Gesellschaftsvertrag o Satzung (statuto o atto costitutivo)Il contratto che regola l’azienda. Per una GmbH si chiama Gesellschaftsvertrag, per una AG e una eG Satzung. |
curl -G "https://handelsregister.ai/api/v1/fetch-document" \ -H "x-api-key: LA_TUA_CHIAVE_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": "LA_TUA_CHIAVE_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": "LA_TUA_CHIAVE_API" }, }); const data = await response.json();
Documenti per forma giuridica
Aktueller Abdruck, Chronologischer Abdruck e Strukturierter Registerinhalt esistono per ogni azienda iscritta. Quali altri documenti depositati esistono dipende dalla forma giuridica.
| Forma giuridica | AD, CD, SI | Elenco soci | Statuto |
|---|---|---|---|
| GmbH, UG | sì | sì, obbligatorio | sì, il Gesellschaftsvertrag |
| AG, SE, KGaA | sì | no | sì, la Satzung |
| eG | sì | no | sì, la Satzung |
| KG, GmbH & Co. KG, OHG | sì | no | di solito no |
| PartG, PartG mbB | sì | no | di solito no |
| e.K. | sì | no | di solito no |
Un elenco soci esiste solo per GmbH e UG. Per altre forme giuridiche e documenti mancanti l’API risponde con 404 e non addebita nulla.
Formati
La risposta è il file stesso, non JSON. Riconosci il tipo dall’header Content-Type, il nome del file dall’header Content-Disposition.
Il nome del file contiene l’entity_id, il tipo di documento e la data di recupero, ad es. document_94eb910fef13f94585c48c263fa446d4_AD_2026-11-01.pdf.
Elenchi soci e statuti sono spesso pagine scansionate, alcune senza livello di testo. Per ottenere il testo ti serve allora un OCR.
Alcuni documenti sono disponibili dal registro solo come immagine TIFF. L’API risponde allora con 415 e non addebita nulla.
Nel nostro esempio di Hetzner Online GmbH i file avevano queste dimensioni: Aktueller Abdruck circa 35 KB, Strukturierter Registerinhalt circa 14 KB, Gesellschaftsvertrag circa 450 KB.
async=true. Se il registro non risponde in tempo, ricevi 504 con Retry-After. In quel caso non viene addebitato nulla.