API reference
API reference
Every endpoint, parameter and response of the Registercheck API.
Every request goes to https://api.registercheck.de/v1 and carries your API key as
Authorization: Bearer <key>; see Authentication.
Each endpoint's page states what it costs. The reference is grouped by the first segment of the
path, and every endpoint in it is served.
The examples on these pages describe made-up companies and people, such as Beispiel Reisen GmbH
(Amtsgericht München HRB 999999) and Erika Mustermann: their ids and register numbers answer 404.
To try a call, use an id from a search of your own.
| Group | What it covers | Endpoints |
|---|---|---|
| Search | Turning a name, a register number or a set of filters into companies and persons. | 4 |
| Formations | Companies whose first register entry is a new registration, newest register day first. | 3 |
| Companies | The register entry itself — name, registered office, purpose, capital, legal form — and everything listed under it: roles, shareholders, holdings, documents, financial statements, tax IDs and the events of one company. | 14 |
| Answers | One question about one company, answered from register data by rules: whether a named person may represent it alone, who its computed beneficial owners are, its current representatives, its shareholders, its seat or its status. | 1 |
| Persons | Natural persons named in the register, the roles they hold and the shareholdings they hold, across every company. | 3 |
| Events | Every change the register courts enter, across all companies, newest register day first. | 4 |
| Documents | Register extracts, shareholder lists and articles of association, by id. | 2 |
| Monitors | Watching a company for the event types you choose. | 5 |
| Destinations | Where your monitors' events are sent: e-mail addresses, Slack channels and webhook URLs. | 6 |
| Deliveries | What was sent to which destination, and the webhook a delivery arrives as. | 5 |
| Lists | Your own lists of companies and persons. | 9 |
| Jobs | Asking for data to be fetched again, and polling the work that follows. | 4 |
| Transparency register | Official extracts of the Transparenzregister (EiS, § 23 Abs. | 12 |
| Reference data | The codes other responses use — legal forms, courts, role types, industries, event types and event groups — with their labels. | 6 |
| Account | The workspace your key acts in, its plan, the credits it has left and your monitor usage. | 1 |
| Platform | Service health. | 1 |