registercheckby openlaw group
API referenceReference data

List event groups

GET
/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
AuthorizationBearer <token>

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

In: header

Query Parameters

limit?integer

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.

Range1 <= value <= 100
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

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