---
title: Get a recipient
description: Get a recipient summary and their certificate issues
method: GET
path: /api/v1/workspaces/{slug}/recipients/{email}
group: Issues
---

# Get a recipient

# Get a recipient

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

```http
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: `ada@example.com`.

## Request

```bash
curl https://api.verifycate.com/api/v1/workspaces/acme/recipients/ada%40example.com \
  -H "Authorization: Bearer vc_your_api_key"
```

```javascript
const email = encodeURIComponent("ada@example.com");
const res = await fetch(
  `https://api.verifycate.com/api/v1/workspaces/acme/recipients/${email}`,
  { headers: { Authorization: "Bearer vc_your_api_key" } },
);
const recipient = await res.json();
```

```go
req, _ := http.NewRequest(
	"GET",
	"https://api.verifycate.com/api/v1/workspaces/acme/recipients/ada%40example.com",
	nil,
)
req.Header.Set("Authorization", "Bearer vc_your_api_key")
```

```python
import urllib.parse
import urllib.request

email = urllib.parse.quote("ada@example.com", safe="")
url = f"https://api.verifycate.com/api/v1/workspaces/acme/recipients/{email}"
req = urllib.request.Request(url, headers={"Authorization": "Bearer vc_your_api_key"})
with urllib.request.urlopen(req) as res:
    print(res.read().decode())
```

## 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 — 

## Response

### 200

```json
{
  "recipient_email": "ada@example.com",
  "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": "ada@example.com",
      "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"
    }
  ]
}
```

### 404

```json
{
  "title": "Not Found",
  "status": 404,
  "detail": "recipient not found",
  "code": "recipient_not_found"
}
```