VerifycateDeveloper Docs

List recipients

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

List distinct recipients across all certificates in a workspace

Lists distinct recipients across all certificates in the workspace, grouped by email. Supports search and offset pagination.

Authorization

Authorization: Bearer vc_...

Requires a full-access API key (empty permissions list) and an active Pro seat. Keys restricted to certificates:read alone cannot call this route — see Scopes.

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

*Recipient[]
Recipients on this page
recipient_email*string
Recipient email
recipient_name*string
Recipient display name
issue_count*integer
Issues for this recipient in the workspace
certificate_count*integer
Distinct certificates for this recipient
latest_created_at*datetime
Newest issue `created_at`
latest_issued_at?datetime
Newest issue `issued_at` when any are issued
total*integer
Total matching rows (not just this page)
limit*integer
Page size used for this response
offset*integer
Number of items skipped