fetch-document
Endpoints
GET

/v1/fetch-document

15 credits • 5/min

Download 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.