Skip to main content
GET
List agent skill certifications

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Headers

X-Test-Mode
enum<string>

Sandbox opt-in for Clerk-session-authenticated requests. Set to true to route the call through the test-mode pipeline: no real provider delivery, no credits deducted, response meta.test_mode: true. Ignored for live API keys (dv_live_sk_*) — server-to-server clients must use a test-prefixed key (dv_test_sk_*) to exercise sandbox. Test-prefixed keys unconditionally enable sandbox regardless of this header.

Available options:
true,
false

Query Parameters

agentUserId
string<uuid>
skill
string
Required string length: 1 - 80
Pattern: ^[a-z0-9_-]+$
status
enum<string>

Filter by effective state. active = never-expires or future window; expired = lapsed; all (default) = no expiry filter.

Available options:
active,
expired,
all
expiringWithinDays
integer

Restrict to windows lapsing within N days and not already lapsed — the 'who's about to expire' supervisor sweep.

Required range: 0 <= x <= 3650
limit
integer
default:200

Maximum certification windows to return per page (1..500, default 200). The result set is keyset-paginated — never the whole table.

Required range: 1 <= x <= 500
cursor
string

Opaque keyset cursor — pass meta.pagination.cursor from the previous page to fetch the next. Omit for the first page.

Required string length: 1 - 512

Response

Successful response.

data
object
required
meta
object
required