Skip to main content
GET https://api.craftkit.dev/v1/renders/:id/shares
Returns all shares for a render, ordered newest-first. Revoked shares are included. Each row carries a clickCount (recipient viewed events attributed to the share). See Sharing.

​
Authorization

​
Authorization
string
required
Bearer ck_live_…

​
Path parameters

​
id
string
required
The render id.

​
Response

200:
​
shares
object[]
Shares for the render, newest first. Revoked shares are included.

​
Errors

StatuscodeMeaning
401unauthorizedMissing/invalid/revoked key.
404not_foundNo render with that id in this key’s project.
cURL
curl https://api.craftkit.dev/v1/renders/$RENDER_ID/shares \
  -H "Authorization: Bearer $CRAFTKIT_API_KEY"
200
{
  "shares": [
    {
      "id": "…",
      "channel": "link",
      "recipientEmail": null,
      "message": "Here is your signed agreement.",
      "revokedAt": null,
      "revokedReason": null,
      "expiresAt": "2026-12-31T23:59:59.000Z",
      "createdAt": "2026-06-05T10:05:00.000Z",
      "shareToken": "cks_…",
      "clickCount": 3,
      "shareUrl": "https://www.craftkit.dev/share/cks_…"
    }
  ]
}