List event groups
The groups of event types — the tiles the monitoring screen shows. A monitor may name a
group instead of its event types (MonitorEventCategory).
A group nothing serves is listed with available: false and the reason, so a client can
render every group from one list instead of hard-coding them. Creating a monitor with
such a group is refused with that reason. Today that is beneficial_owners.
Replaces unavailable_groups on the retired GET /monitor-event-types.
Free.
Authorization
bearerAuth Your API key, sent as Authorization: Bearer rc_prod_….
In: header
Query Parameters
Page size, 1 to 100. Omit it to receive the whole list in one page, next_cursor null:
these lists publish fixed vocabularies a client reads in one call, /industries'
2,030 codes included. Name a limit below the list's size and the answer pages.
1 <= value <= 100The 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
curl -X GET "https://api.registercheck.de/v1/event-groups" \ -H "Authorization: Bearer $REGISTERCHECK_API_KEY"{ "object": "page", "next_cursor": null, "data": [ { "object": "event_group", "id": "representation", "label": "Representation", "label_de": "Vertretung", "available": true, "unavailable_reason": null }, { "object": "event_group", "id": "capital", "label": "Capital", "label_de": "Kapital", "available": true, "unavailable_reason": null }, { "object": "event_group", "id": "shareholders", "label": "Shareholders", "label_de": "Gesellschafter", "available": true, "unavailable_reason": null }, { "object": "event_group", "id": "registered_office", "label": "Registered office & address", "label_de": "Sitz & Anschrift", "available": true, "unavailable_reason": null }, { "object": "event_group", "id": "identity", "label": "Company identity", "label_de": "Firma", "available": true, "unavailable_reason": null }, { "object": "event_group", "id": "conversion", "label": "Conversion", "label_de": "Umwandlung", "available": true, "unavailable_reason": null }, { "object": "event_group", "id": "insolvency", "label": "Insolvency", "label_de": "Insolvenz", "available": true, "unavailable_reason": null }, { "object": "event_group", "id": "financial_statement", "label": "Annual accounts", "label_de": "Jahresabschluss", "available": true, "unavailable_reason": null }, { "object": "event_group", "id": "dissolution", "label": "Dissolution & deregistration", "label_de": "Auflösung & Löschung", "available": true, "unavailable_reason": null }, { "object": "event_group", "id": "other_entries", "label": "Other register entries", "label_de": "Sonstige Eintragungen", "available": true, "unavailable_reason": null }, { "object": "event_group", "id": "beneficial_owners", "label": "Beneficial owners", "label_de": "Wirtschaftlich Berechtigte", "available": false, "unavailable_reason": "No data source. Beneficial ownership lives in the Transparenzregister, which this estate does not collect: there is no table and no event type for it." } ]}