registercheckby openlaw group
API referenceCompanies

List a company's register documents

GET
/companies/{company_id}/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
AuthorizationBearer <token>

Your API key, sent as Authorization: Bearer rc_live_….

In: header

Path Parameters

company_id*string

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.

Match^cmp_[0-7][0-9a-hjkmnp-tv-z]{25}$

Query Parameters

type?array<>

Only documents of these types. Repeat the parameter for several.

limit?integer

Page size, 1 to 100.

Range1 <= value <= 100
Default20
cursor?string

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

Length1 <= length <= 2000

Response 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"      }    }  ]}