List a company's register history
Changes the register court entered for this company, newest first: the same list as
GET /events?subject_id={company_id}. Each event carries the value the entry set and,
where an earlier entry of the same type exists, the value it replaced. The type is read from what the entry says (see
EventType), and an entry that only repeats the registered office, name,
capital, purpose or address the previous entry of its kind set is not listed. Every
register event across all companies is GET /events.
Costs 10 credits.
Authorization
bearerAuth Your API key, sent as Authorization: Bearer rc_live_….
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 events of these types.
Only events effective on or after this date.
^[0-9]{4}-[0-9]{2}-[0-9]{2}$dateOnly events effective on or before this date.
^[0-9]{4}-[0-9]{2}-[0-9]{2}$dateOnly company.role.* events about roles of these types. Repeat the parameter for several.
items <= 10Only events Registercheck recorded at or after this instant.
^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]+)?Z$date-timeOnly events Registercheck recorded at or before this instant.
^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]+)?Z$date-timePage 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
curl -X GET "https://api.registercheck.de/v1/companies/cmp_01hxn3rys1fh58w4d1pb1x9s81/events" \ -H "Authorization: Bearer $REGISTERCHECK_API_KEY"{ "object": "page", "data": [ { "object": "event", "id": "evt_0dkj5qmvty9my8pagz1terryva", "type": "company.address.changed", "subject": { "object": "company", "id": "cmp_01hxn3rys1fh58w4d1pb1x9s81", "name": "Beispiel Reisen GmbH" }, "data": { "previous": { "street": "Beispielweg 4", "postal_code": "82152", "city": "Musterstadt", "state": "DE-BY", "country": "DE", "formatted": "Beispielweg 4, 82152 Musterstadt", "coordinates": null }, "current": { "street": "Musterstraße 1", "postal_code": "80331", "city": "München", "state": "DE-BY", "country": "DE", "formatted": "Musterstraße 1, 80331 München", "coordinates": null } }, "source": { "object": "register_entry", "id": "rge_5eky11h94ab0x8v3mycttnj4ja", "number": 7, "published_on": null, "text": "Musterstraße 1, 80331 München" }, "effective_date": "2024-06-01", "created_at": "2024-06-01T10:14:02Z" }, { "object": "event", "id": "evt_3ydne4pehf9resr2wafxq5tk1v", "type": "company.role.added", "subject": { "object": "company", "id": "cmp_01hxn3rys1fh58w4d1pb1x9s81", "name": "Beispiel Reisen GmbH" }, "data": { "holder": { "object": "person", "id": "per_01hxn3rys1fh58w4d1pb1x9s82", "name": "Erika Mustermann" }, "role_type": "managing_director" }, "source": { "object": "register_entry", "id": "rge_0gv3hz4gz3agas0twmcx1hzf6a", "number": 2, "published_on": null, "text": null }, "effective_date": "2010-01-15", "created_at": "2010-01-15T08:02:55Z" } ], "next_cursor": null}