Get a recipient

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

Get a recipient summary and their certificate issues

Returns a recipient summary and all of their certificate issues in the workspace. Email in the path is case-insensitive; URL-encode special characters.

Authorization

Authorization: Bearer vc_...

Requires a full-access API key (empty permissions list) and an active Pro seat.

Path parameters

slug*string

Workspace slug

Example: acme

email*string

Recipient email (URL-encoded)

Example: [email protected]

Response schema

certificate_count*integer

issue_count*integer

issues*array

last_engaged_at?string

latest_created_at*string

latest_issued_at?string

recipient_email*string

recipient_name*string

{ "recipient_email": "[email protected]", "recipient_name": "Ada Lovelace", "issue_count": 1, "certificate_count": 1, "latest_created_at": "2026-09-03T08:10:00Z", "latest_issued_at": "2026-09-03T09:00:00Z", "issues": [ { "id": "9b2c1d4e-5f67-4890-a123-456789abcdef", "certificate_id": "550e8400-e29b-41d4-a716-446655440000", "certificate_name": "Python Fundamentals", "public_id": "vc_pub_ada01", "recipient_email": "[email protected]", "recipient_name": "Ada Lovelace", "status": "active", "issued_at": "2026-09-03T09:00:00Z", "expires_at": "2027-09-03T09:00:00Z", "created_at": "2026-09-03T08:10:00Z", "updated_at": "2026-09-03T09:00:00Z" } ] }