Documentos
Quais documentos existem e em que formato.
Com fetch-document, você baixa documentos oficiais do registro como arquivo. Passe o entity_id da empresa em company_id e escolha um document_type. Cada documento entregue custa 15 créditos.
Tipos de documento
Existem cinco tipos de documento. Escreva os valores de document_type exatamente como na tabela, incluindo maiúsculas e minúsculas. A requisição de exemplo obtém o Aktueller Abdruck da Hetzner Online GmbH, Ansbach HRB 6089.
| document_type | Documento | Formato |
|---|---|---|
| AD | Aktueller Abdruck (extrato atual)Todos os registros válidos hoje. O extrato clássico do registro. | |
| CD | Chronologischer Abdruck (extrato cronológico)Todos os registros em ordem cronológica, inclusive os cancelados, desde que o registro é mantido eletronicamente. | |
| SI | Strukturierter Registerinhalt (conteúdo estruturado do registro)O conteúdo do registro como XML no padrão XJustiz, bom para processamento automático. | XML |
| shareholders_list | Gesellschafterliste (lista de sócios)A lista de sócios com suas quotas, como a GmbH a deposita no registro. | |
| articles_of_association | Gesellschaftsvertrag ou Satzung (contrato social ou estatuto)O contrato que rege a empresa. Numa GmbH ele se chama Gesellschaftsvertrag, numa AG e numa eG Satzung. |
curl -G "https://handelsregister.ai/api/v1/fetch-document" \ -H "x-api-key: SUA_CHAVE_DE_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": "SUA_CHAVE_DE_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": "SUA_CHAVE_DE_API" }, }); const data = await response.json();
Documentos por forma jurídica
Aktueller Abdruck, Chronologischer Abdruck e Strukturierter Registerinhalt existem para toda empresa registrada. Quais documentos depositados existem além disso depende da forma jurídica.
| Forma jurídica | AD, CD, SI | Lista de sócios | Contrato social |
|---|---|---|---|
| GmbH, UG | sim | sim, obrigatória | sim, o Gesellschaftsvertrag |
| AG, SE, KGaA | sim | não | sim, a Satzung |
| eG | sim | não | sim, a Satzung |
| KG, GmbH & Co. KG, OHG | sim | não | geralmente não |
| PartG, PartG mbB | sim | não | geralmente não |
| e.K. | sim | não | geralmente não |
Uma lista de sócios só existe para GmbH e UG. Para outras formas jurídicas e documentos inexistentes, a API responde com 404 e não cobra nada.
Formatos
A resposta é o próprio arquivo, não JSON. Você reconhece o tipo pelo header Content-Type e o nome do arquivo pelo header Content-Disposition.
O nome do arquivo contém o entity_id, o tipo de documento e a data da consulta, p. ex. document_94eb910fef13f94585c48c263fa446d4_AD_2026-11-01.pdf.
Listas de sócios e contratos sociais costumam ser páginas digitalizadas, algumas sem camada de texto. Para obter o texto, você precisa então de OCR.
Alguns documentos só estão disponíveis no registro como imagem TIFF. A API então responde com 415 e não cobra nada.
No nosso exemplo da Hetzner Online GmbH, os arquivos tinham estes tamanhos: Aktueller Abdruck cerca de 35 KB, Strukturierter Registerinhalt cerca de 14 KB, Gesellschaftsvertrag cerca de 450 KB.
async=true. Se o registro não responder a tempo, você recebe 504 com Retry-After. Nada é cobrado nesse caso.