List a company's register documents
Documents retrieved from the register for this company, newest first: by the document's
date in the register (published_date), and after those the documents the register gives
no date for, the most recently retrieved first. Each carries a links.download, which is
its download URL, or null when we hold no downloadable copy.
Copies of one file are listed once. For a GmbH or UG whose register file lists articles of association we do not hold yet, the request asks the register for them, and they are listed once fetched.
A company that was merged into another returns 301 with the surviving company's documents
in Location; the redirect is not charged. When the surviving company is no longer public, the
merged id answers 404 not_found, like an id that was never there.
Costs 1 credit.
Authorization
bearerAuth Your API key, sent as Authorization: Bearer rc_prod_….
In: header
Path Parameters
The company's id (cmp_…). The raw UUID /v1 published before is still read until 2026-12-31,
and such a request is answered with Deprecation and Sunset. An id of another kind, or
anything else, answers 400 validation_failed naming company_id.
^cmp_[0-7][0-9a-hjkmnp-tv-z]{25}$Query Parameters
Only documents of these types. Repeat the parameter for several.
Page size, 1 to 100.
1 <= value <= 10020The next_cursor of the previous page; leave it out for the first page. Opaque: pass it
back as it came. A cursor from another list, or from the same list with other filters,
answers 400 validation_failed naming cursor.
1 <= length <= 2000Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://api.registercheck.de/v1/companies/cmp_01hxn3rys1fh58w4d1pb1x9s81/documents?type=shareholder_list" \ -H "Authorization: Bearer $REGISTERCHECK_API_KEY"{ "object": "page", "next_cursor": null, "data": [ { "id": "doc_3cfp79y2gv9gprwftabdp7v3mz", "object": "document", "company_id": "cmp_01hxn3rys1fh58w4d1pb1x9s81", "type": "shareholder_list", "title": "Gesellschafterliste-BeispielReisenGmbH.pdf", "published_date": "2024-06-01", "retrieved_at": "2024-06-02T08:12:30Z", "content_type": null, "links": { "download": "https://api.registercheck.de/v1/documents/doc_3cfp79y2gv9gprwftabdp7v3mz/content" } } ]}