registercheckby openlaw group
API referenceMonitoring

List alerts

GET
/alerts

What changed on the companies you monitor, newest first.

One alert is one change reported to one monitor. The same change reported to two of your monitors is two alerts; the same change is never two alerts for one monitor.

effective_date is the date the register recorded the entry and can be years before created_at, which is when this estate detected it — a monitor reports an entry whatever its date, so an alert about a 2018 relocation can arrive today.

notified is false for a change that was detected but not sent to you — either because delivery is not switched on for your account yet, or because you had no active notification endpoint when the change was decided (adding one afterwards does not resend it). Changes suppressed for any other reason — a duplicate of one you already had, a first observation, a superseded decision — are not alerts and are not listed.

Free.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Query Parameters

company_id?string

Only alerts for this company.

Formatuuid
monitor_id?string

Only alerts for this monitor.

limit?integer

Page size.

Range1 <= value <= 100
Default20
starting_after?string

Return the page after the object with this id. Cannot be combined with ending_before.

Formatuuid
ending_before?string

Return the page before the object with this id. Cannot be combined with starting_after.

Formatuuid

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://api.registercheck.de/v1/alerts" \  -H "Authorization: Bearer $REGISTERCHECK_API_KEY"
{  "object": "list",  "has_more": true,  "data": [    {      "id": "string",      "object": "alert",      "monitor_id": "string",      "company": {        "object": "company",        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "name": "string"      },      "event_type": "*",      "label": "string",      "label_de": "string",      "previous": "string",      "current": "string",      "effective_date": "2019-08-24",      "created_at": "2019-08-24T14:15:22Z",      "notified": true    }  ]}