Create a list
Send an Idempotency-Key to retry safely: a repeated request with the same key
returns the list created the first time instead of a second list.
Free.
Authorization
bearerAuth Your API key, sent as Authorization: Bearer rc_prod_….
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.
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 new list.
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
curl -X POST "https://api.registercheck.de/v1/lists" \ -H "Authorization: Bearer $REGISTERCHECK_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "KYB queue", "description": "Companies and people to screen before onboarding.", "emoji": "🧾", "tags": [ "kyb" ], "metadata": { "team": "kyc" } }'{ "object": "list", "id": "lst_1c9sn8p79z99e9wyrf38nkrkay", "name": "KYB queue", "description": "Companies and people to screen before onboarding.", "emoji": "🧾", "tags": [ "kyb" ], "item_count": 0, "metadata": { "team": "kyc" }, "created_at": "2026-09-28T09:12:33Z", "updated_at": "2026-09-28T09:12:33Z"}