registercheckby openlaw group
API referenceLists

Create a list

POST
/lists

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
AuthorizationBearer <token>

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

In: header

Header Parameters

Idempotency-Key?string

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.

Length1 <= length <= 255

Request 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"}