VerifycateDeveloper Docs

List certificates

GET/api/v1/workspaces/{slug}/certificates

List certificates in a workspace with search and pagination

Lists certificates in the workspace. Each item may include an embedded template draft JSON when one exists. Supports search and offset pagination.

Authorization

Scopecertificates:read
Authorization: Bearer vc_...

Requires a workspace API key with certificates:read (or full access) and an active Pro seat.

Path parameters

slug*string

Workspace slug

Example: acme

Query parameters

limit?integer

Page size (1–200). Defaults to 50.

Example: 50
offset?integer

Number of items to skip. Defaults to 0.

Example: 0

Response schema

*Certificate[]
Certificates on this page
id*UUID
Certificate id
workspace_id*UUID
Owning workspace id
name*string
Certificate name
status*string
`draft`, `active`, or `archived`
validity_days?integer
Days until issued credentials expire; null if no expiry
request_form_enabled*boolean
Whether the public request form is enabled
require_request_form_submission*boolean
Hold imported recipients until they submit the request form
request_form_mode*string
Request form approval mode (e.g. `manual_approval`)
correction_form_enabled*boolean
Whether the correction form is enabled
correction_form_mode*string
Correction form approval mode
request_form_token?string
Public request-form token when enabled
correction_form_token?string
Public correction-form token when enabled
attributes*object[]
Attribute definitions (`key`, `label`, …)
request_form_fields*object[]
Request form field definitions
correction_form_fields*object[]
Correction form field definitions
description*string
What this certificate represents
certificate_type?string
One of `certificate`, `badge`, `certification`, `course`, `workshop`, `event`, `membership`, `recognition`
level?string
One of `beginner`, `intermediate`, `advanced`, `professional`
duration?string
Free-text time to earn
learn_more_url?string
`http` or `https` URL
earning_criteria*string[]
Criteria listed on the credential
created_at*datetime
Created timestamp (RFC 3339)
updated_at*datetime
Updated timestamp (RFC 3339)
template?object
Embedded template canvas JSON when a draft exists
total*integer
Total matching rows (not just this page)
limit*integer
Page size used for this response
offset*integer
Number of items skipped