registercheckby openlaw group
API referenceEvents

List events

Deprecated

GET
/company-events

Deprecated: use GET /events. This is the market-wide list of GET /events under its previous name: the same answer and the same price, read from the same list. Two filters keep their previous names here: officer_role (role_type there) and q (name there); subject_id and monitor_id exist only there. This path keeps working until 31 December 2026 and sends Deprecation, Sunset and Link with its answers.

Costs 10 credits per page.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Query Parameters

type?array<>

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

Itemsitems <= 30
officer_role?array<>

Only company.role.* events concerning roles of these types. Repeat the parameter for several.

Itemsitems <= 10
effective_date[gte]?string

First register day to include. Without any effective_date[*] or created_at[*] bound, the list covers the last 30 days; with any of them it covers the whole 180-day window. Older than 180 days answers 400 validation_failed.

Match^[0-9]{4}-[0-9]{2}-[0-9]{2}$
Formatdate
effective_date[lte]?string

Last register day to include.

Match^[0-9]{4}-[0-9]{2}-[0-9]{2}$
Formatdate
created_at[gte]?string

Only events that became available through this API at or after this instant. Poll on this.

Match^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]+)?Z$
Formatdate-time
created_at[lte]?string

Only events that became available through this API at or before this instant.

Match^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]+)?Z$
Formatdate-time
legal_form?array<>

Only companies of these legal forms. Repeat the parameter for several (legal_form=gmbh&legal_form=ug).

Itemsitems <= 40
state?array<>

Only companies in these federal states, as ISO 3166-2 codes (DE-BY). Repeat the parameter for several.

Itemsitems <= 16
registered_office?array<>

Only companies with these registered offices (Sitz). Exact match, ignoring case and umlaut spelling (Muenchen matches München). Repeat the parameter for several.

Itemsitems <= 50
register_court?string

Only companies registered at this court: its code (D2601), its name (Amtsgericht München) or its seat (München), as POST /monitors accepts it.

Length1 <= length <= 100
capital[gte]?string

Minimum registered capital in EUR, as a decimal (25000 or 25000.00). Companies without EUR capital are excluded when either capital bound is set.

Match^(0|[1-9][0-9]{0,11})(\.[0-9]{1,2})?$
capital[lte]?string

Maximum registered capital in EUR, as a decimal.

Match^(0|[1-9][0-9]{0,11})(\.[0-9]{1,2})?$
q?string

Words that must all appear, ignoring case and umlaut spelling, in the company name, the registered office, the court, the register number or the entry's own text. Not matched against people's names.

Length2 <= length <= 100
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

curl -X GET "https://api.registercheck.de/v1/company-events" \  -H "Authorization: Bearer $REGISTERCHECK_API_KEY"
{  "object": "page",  "data": [    {      "object": "event",      "id": "evt_1c9sn8p79z99e9wyrf38nkrkay",      "type": "company.registered_office.changed",      "subject": {        "object": "company",        "id": "cmp_1z3gn9wpvx9j59w8bd9w5rm72n",        "name": "Beispiel Analytics GmbH"      },      "data": {        "previous": "München",        "current": "Augsburg"      },      "source": {        "object": "register_entry",        "id": "rge_5eky11h94ab0x8v3mycttnj4ja",        "number": 7,        "published_on": null,        "text": "Augsburg"      },      "effective_date": "2026-09-21",      "created_at": "2026-09-21T10:14:02Z"    },    {      "object": "event",      "id": "evt_2vfpfhmf2y9dyrz6gv5gymwqv0",      "type": "company.role.added",      "subject": {        "object": "company",        "id": "cmp_4x9gd2pzkf99drrf9e3w59q302",        "name": "Beispiel Bau Holding GmbH"      },      "data": {        "holder": {          "object": "person",          "id": null,          "name": "Erika Mustermann"        },        "role_type": "managing_director"      },      "source": {        "object": "register_entry",        "id": "rge_5rdf656qw1btfsfqeksnp4jt64",        "number": 4,        "published_on": null,        "text": null      },      "effective_date": "2026-09-21",      "created_at": "2026-09-21T09:58:40Z"    }  ],  "next_cursor": "eyJ2IjoxLCJrIjoibGlzdEV2ZW50czozYzFlOWEwYjdkMmY0ZTYxIiwiYSI6IjViN2Q5ZjFhLTNjNWUtNGI3ZC04ZjlhLTFiMmMzZDRlNWY2MCJ9"}