Documentos
Qué documentos existen y en qué formato.
Con fetch-document descargas documentos oficiales del registro como archivo. Pasa la entity_id de la empresa en company_id y elige un document_type. Cada documento entregado cuesta 15 créditos.
Tipos de documento
Hay cinco tipos de documento. Escribe los valores de document_type exactamente como en la tabla, con mayúsculas y minúsculas. La solicitud de ejemplo obtiene el Aktueller Abdruck de Hetzner Online GmbH, Ansbach HRB 6089.
| document_type | Documento | Formato |
|---|---|---|
| AD | Aktueller Abdruck (extracto actual)Todas las inscripciones vigentes hoy. El extracto registral clásico. | |
| CD | Chronologischer Abdruck (extracto cronológico)Todas las inscripciones en orden cronológico, incluidas las canceladas, desde que el registro se lleva de forma electrónica. | |
| SI | Strukturierter Registerinhalt (contenido estructurado del registro)El contenido del registro como XML en el estándar XJustiz, adecuado para el procesamiento por máquina. | XML |
| shareholders_list | Gesellschafterliste (lista de socios)La lista de socios con sus participaciones, tal como la GmbH la presenta en el registro. | |
| articles_of_association | Gesellschaftsvertrag o Satzung (estatutos)El contrato que rige la empresa. En una GmbH se llama Gesellschaftsvertrag, en una AG y una eG Satzung. |
curl -G "https://handelsregister.ai/api/v1/fetch-document" \ -H "x-api-key: TU_CLAVE_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": "TU_CLAVE_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": "TU_CLAVE_API" }, }); const data = await response.json();
Documentos por forma jurídica
Aktueller Abdruck, Chronologischer Abdruck y Strukturierter Registerinhalt existen para toda empresa inscrita. Qué documentos presentados existen además depende de la forma jurídica.
| Forma jurídica | AD, CD, SI | Lista de socios | Estatutos |
|---|---|---|---|
| GmbH, UG | sí | sí, obligatoria | sí, el Gesellschaftsvertrag |
| AG, SE, KGaA | sí | no | sí, la Satzung |
| eG | sí | no | sí, la Satzung |
| KG, GmbH & Co. KG, OHG | sí | no | normalmente no |
| PartG, PartG mbB | sí | no | normalmente no |
| e.K. | sí | no | normalmente no |
Una lista de socios solo existe para GmbH y UG. Para otras formas jurídicas y documentos inexistentes, la API responde con 404 y no cobra nada.
Formatos
La respuesta es el propio archivo, no JSON. El tipo lo reconoces por el header Content-Type, el nombre del archivo por el header Content-Disposition.
El nombre del archivo contiene la entity_id, el tipo de documento y la fecha de obtención, p. ej. document_94eb910fef13f94585c48c263fa446d4_AD_2026-11-01.pdf.
Las listas de socios y los estatutos suelen ser páginas escaneadas, algunas sin capa de texto. Para obtener el texto necesitas entonces OCR.
Algunos documentos solo están disponibles en el registro como imagen TIFF. La API responde entonces con 415 y no cobra nada.
En nuestro ejemplo de Hetzner Online GmbH, los archivos tenían estos tamaños: Aktueller Abdruck unos 35 KB, Strukturierter Registerinhalt unos 14 KB, Gesellschaftsvertrag unos 450 KB.
async=true. Si el registro no responde a tiempo, recibes 504 con Retry-After. Entonces no se cobra nada.