List all identifiers on the block-list | Clerk API (unofficial showcase)

3 status codes

200Success

dataarray<object>required

total_countintegerrequired

Total number of blocklist identifiers

401Authentication invalid

errorsarray<object>required

metaobjectoptional

clerk_trace_idstringoptional

402Payment required

errorsarray<object>required

metaobjectoptional

clerk_trace_idstringoptional

Error handling

A 401 is returned: Authentication invalid. A 402 is returned: Payment required.

import { Client } from "@octridev/clerk";

const client = new Client({
  baseUrl: "https://api.clerk.com/v1",
  auth: { bearer: process.env.API_TOKEN },
});

const result = await client.blocklistIdentifiers.list();

{
  "data": [
    {
      "object": "blocklist_identifier",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "identifier": "example_value",
      "identifier_type": "email_address",
      "instance_id": "550e8400-e29b-41d4-a716-446655440000",
      "created_at": 1,
      "updated_at": "2026-01-15T09:00:00Z"
    }
  ],
  "total_count": 42
}

Response

Errors