Create a monitor
Starts watching a company. Register changes of the chosen event types are
listed by GET /events?monitor_id= and delivered to your destinations
(/destinations); GET /deliveries lists what was sent where.
Name the company by subject_id, or by its register identity in register
({"court": "München", "type": "HRB", "number": "292661"}, the shape of
company.register) and skip the search. An identity that matches no visible company answers 404; one
that matches several answers 409 listing every candidate.
A company can have one monitor per account; creating a second answers 409 with the
existing monitor's id in existing_id.
Costs 10 credits, once.
Through a connection of the Registercheck MCP server a monitor costs no credits. It counts
against the free limit on monitored companies instead. The count is per person, across
every workspace, and includes monitors created in the app (monitors created with an API
key do not count). Once the limit is reached, a create answers 403
monitor_limit_reached, unless the workspace the connection acts in has a plan.
Authorization
bearerAuth Your API key, sent as Authorization: Bearer rc_live_….
In: header
Header Parameters
Makes a retry safe. A request repeated with the same key within 24 hours returns
the first successful response (with Idempotent-Replayed: true) instead of acting
twice; an error is not stored, so its retry runs again. Reusing a key with a different
body returns 422; retrying while the first request is still running returns 409.
Use a random UUID.
1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
A new monitor. Name the company by subject_id or by register (its register identity), not both.
company_id, the name before the October 2026 release, is refused with a 400.
A new monitor. Name the company by subject_id or by register (its register identity), not both.
company_id, the name before the October 2026 release, is refused with a 400.
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
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://api.registercheck.de/v1/monitors" \ -H "Authorization: Bearer $REGISTERCHECK_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "register": { "court": "München", "type": "HRB", "number": "292661" }, "event_types": [ "representation", "capital" ], "metadata": { "crm_id": "0015g00000XyZ" } }'{ "id": "mon_3wksk7jx1583f98jz0fz0zj2q7", "object": "monitor", "subject": { "object": "company", "id": "cmp_1z3gn9wpvx9j59w8bd9w5rm72n", "name": "string" }, "event_types": [ "*" ], "unavailable_event_types": [ "*" ], "status": "active", "metadata": { "crm_id": "0015g00000XyZ", "team": "kyc" }, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}