Skip to main content
GET https://api.craftkit.dev/v1/renders/:id/engagement
Returns per-type engagement counts, a linkOpens tally, the grand total, and up to the 25 most recent events (newest first) for a single render. Scoped to your API key’s project.

​
Authorization

​
Authorization
string
required
Bearer ck_live_… — a project API key.

​
Path parameters

​
id
string
required
The render id. Must belong to this key’s project.

​
Response

200 with the engagement summary.
​
counts
object
Per-type event counts. Always contains all seven keys, zero-filled when there is no activity.
​
linkOpens
number
Subset of viewed events that came through a shared link (shareId is non-null). Separates link traffic from in-dashboard views.
​
total
number
Sum of all counts.
​
recent
object[]
Up to 25 most recent events, newest first.

​
Errors

StatuscodeMeaning
401unauthorizedMissing, invalid, or revoked key.
403forbiddenKey’s project no longer exists.
404not_foundNo render with that id in this key’s project.
cURL
curl https://api.craftkit.dev/v1/renders/$RENDER_ID/engagement \
  -H "Authorization: Bearer $CRAFTKIT_API_KEY"
200
{
  "counts": {
    "viewed": 12,
    "downloaded": 3,
    "printed": 1,
    "email_opened": 4,
    "email_sent": 2,
    "share_created": 1,
    "share_revoked": 0
  },
  "linkOpens": 8,
  "total": 23,
  "recent": [
    {
      "id": "…",
      "eventType": "viewed",
      "actorKind": "recipient",
      "shareId": "…",
      "sourceIp": "203.0.113.7",
      "userAgent": "Mozilla/5.0 …",
      "metadata": null,
      "createdAt": "2026-05-03T10:20:00.000Z"
    }
  ]
}