List an email’s share links
GET/v1/emails/{id}/shares
The links made for an email, with whether each still works (active, expired or revoked) and how many times it was opened. The address itself is never shown again.
Required scope: emails:read
Parameters
| Name | In | Description |
|---|---|---|
idrequired | path | The email id. |
Example
curl -X GET 'https://api.sendsend.email/v1/emails/ID/shares' \
-H "Authorization: Bearer $SENDSEND_API_KEY"Response 200
{
"object": "list",
"data": [
{
"id": "shr_4Tq9…",
"object": "email_share",
"created_at": "2026-10-26T15:04:05.000Z",
"expires_at": "2026-10-27T15:04:05.000Z",
"full_addresses": false,
"show_subject": true,
"status": "active",
"views": 2,
"last_viewed_at": "2026-10-26T16:10:00.000Z"
}
]
}Errors
| Status | Code | When |
|---|---|---|
| 404 | not_found | No such resource in this project. |
| 401 | unauthorized | The API key is missing, invalid or revoked. |
| 403 | forbidden | The key does not have the scope this endpoint needs. |
Every error has the same shape. See Errors.