List a user's biometric credentials | Clerk API (unofficial showcase)

1 parameter

user_idstringrequired

The ID of the user whose biometric credentials are returned

4 status codes

200Success

dataarray<object>required

total_countintegerrequired

Total number of biometric credentials

403Authorization invalid

errorsarray<object>required

metaobjectoptional

clerk_trace_idstringoptional

404Resource not found

errorsarray<object>required

metaobjectoptional

clerk_trace_idstringoptional

500Request was not successful

errorsarray<object>required

metaobjectoptional

clerk_trace_idstringoptional

Error handling

A 403 is returned: Authorization invalid. A 404 is returned: Resource not found. A 500 is returned: Request was not successful.

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.biometricCredentials.list({ userId: "c0a80123-4567-89ab-cdef-0123456789ab" });

{
  "data": [
    {
      "object": "trusted_device",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "platform": "ios",
      "app_identifier": "example_value",
      "name": "Example Name",
      "algorithm": "ES256",
      "status": "active",
      "created_at": 1,
      "updated_at": "2026-01-15T09:00:00Z",
      "last_used_at": 1,
      "revoked_at": 1
    }
  ],
  "total_count": 42
}

Request

Response

Errors