Add a company or person to a list
You send only its id; the name is resolved from the register. Adding a company or
person that is already on the list answers 200 with the item as it is, and changes
nothing: its note and metadata stay. Change them with updateListItem. One the register
no longer holds is answered 404, as a first add would be.
Free.
Authorization
bearerAuth Your API key, sent as Authorization: Bearer rc_prod_….
In: header
Path Parameters
The list's id (lst_…). Until 2026-12-31 a raw UUID is still accepted, and the
response says so with Deprecation and Sunset.
^lst_[0-7][0-9a-hjkmnp-tv-z]{25}$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.
A response that carries a webhook's signing secret is not stored: retrying such a
POST /destinations answers 409 with existing_id. Use a random UUID.
1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
A company or person to add. Send only its id.
Response Body
application/json
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
curl -X POST "https://api.registercheck.de/v1/lists/lst_03jpxwnd679fz8jjz4wm15dq4g/items" \ -H "Authorization: Bearer $REGISTERCHECK_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "subject_id": "per_01hxn3rys1fh58w4d1pb1x9s82" }'{ "object": "list_item", "id": "lsi_2vfpfhmf2y9dyrz6gv5gymwqv0", "list_id": "lst_1c9sn8p79z99e9wyrf38nkrkay", "subject": { "object": "company", "id": "cmp_01hxn3rys1fh58w4d1pb1x9s81", "name": "Beispiel Reisen GmbH" }, "note": "Screen before the October board meeting.", "metadata": {}, "created_at": "2026-09-28T09:15:00Z"}