/v1/fetch-document
15 credits • 5/minDownload official documents from the German commercial register — PDF or XML depending on the document type.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| api_key | string | Conditional* | Your API key. Only required if you use neither the x-api-key header nor a Bearer token. |
| company_id | string | REQUIRED | The company's entity_id, e.g. from search results. |
| document_type | string | REQUIRED | Document type. Values: shareholders_list, articles_of_association, AD, CD, SI |
Example Request
curl 'https://handelsregister.ai/api/v1/fetch-document?api_key=your_api_key_here&company_id=20a1510e88cd2e9b166db4d0bc5d563d&document_type=shareholders_list' \
-o document.pdf
Response
Success (200): Returns the document itself as a file — PDF for AD, CD, shareholders_list, and articles_of_association, XML for SI.
Content-Type: application/pdf · application/xml (application/pdf for AD, CD, shareholders_list, articles_of_association — application/xml for SI.)
Error: Returns JSON with the error details.
Document Types
shareholders_list
List of shareholders
articles_of_association
Articles of association / bylaws / statute
AD
Current register excerpt (Aktuelle Daten)
CD
Chronological register excerpt (Chronologische Daten)
SI
Structured register content — returned as an XML file.