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

search?string

Filter by name, email, or certificate name

Example: ada

status?string

Filter by recipient status. Takes the same values as List issues.

Example: issued

certificate?UUID

Only recipients of this certificate

Example: 550e8400-e29b-41d4-a716-446655440000

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

items*array

limit*integer

offset*integer

total*integer