registercheckby openlaw group
API referenceDestinations

Send a test delivery

POST
/destinations/{destination_id}/test

Send one signed delivery to this webhook destination, so you can check that your server verifies the signature and reads the body.

The delivery's test is true. It carries one invented event, company.name.changed, for Beispiel GmbH, with a company id no company has and no register data. It is not a change we observed. The same object is what your server receives.

Webhook destinations only. An e-mail address or a Slack channel answers 400 invalid_request, and so do a disabled destination and a webhook whose host is not a public address. A webhook the plan does not cover answers 403 destination_requires_plan. You may send at most 10 test deliveries in a rolling hour, to all your destinations together; the next answers 429 rate_limited with Retry-After.

A test is sent once, without retries, and its outcome does not count towards switching the destination off. The delivery's id is the svix-id of the signed request. A test is not listed by GET /deliveries.

Free.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Path Parameters

destination_id*string

The destination's id (dst_…). The id it is stored under -- a UUID, or the readable id of a destination created before this API existed -- is still accepted until 2026-12-31.

Match^dst_[0-7][0-9a-hjkmnp-tv-z]{25}$

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://api.registercheck.de/v1/destinations/dst_6hq30w96je9rnrmw1tknzhwb2n/test" \  -H "Authorization: Bearer $REGISTERCHECK_API_KEY"
{  "object": "delivery",  "test": true,  "id": "dlv_3f3gn9wpvx9j59w8bd9w5rm72n",  "destination_id": "dst_6hq30w96je9rnrmw1tknzhwb2n",  "cadence": "instant",  "status": "pending",  "attempt_count": 0,  "events": [    {      "object": "event",      "id": "evt_3wksk7jx1583f98jz0fz0zj2q7",      "type": "company.name.changed",      "subject": {        "object": "company",        "id": "cmp_00000000000000000000000000",        "name": "Beispiel GmbH"      },      "data": {        "previous": null,        "current": null      },      "source": null,      "effective_date": null,      "created_at": "2026-11-10T12:00:00Z"    }  ],  "created_at": "2026-11-10T12:00:00Z",  "sent_at": null}