> ## Documentation Index
> Fetch the complete documentation index at: https://docs.craftkit.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# List shares

> GET /v1/renders/:id/shares — list every share for a render, newest first, revoked included.

<Info>**GET** `https://api.craftkit.dev/v1/renders/:id/shares`</Info>

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](/guides/sharing).

## Authorization

<ParamField header="Authorization" type="string" required>`Bearer ck_live_…`</ParamField>

## Path parameters

<ParamField path="id" type="string" required>The render id.</ParamField>

## Response

`200`:

<ResponseField name="shares" type="object[]">
  Shares for the render, newest first. Revoked shares are included.

  <Expandable title="share">
    <ResponseField name="id" type="string" />

    <ResponseField name="channel" type="string">`link` or `email`.</ResponseField>

    <ResponseField name="recipientEmail" type="string | null" />

    <ResponseField name="message" type="string | null" />

    <ResponseField name="revokedAt" type="string | null">ISO 8601, or `null` if active.</ResponseField>
    <ResponseField name="revokedReason" type="string | null">e.g. `revoked_by_partner`.</ResponseField>

    <ResponseField name="expiresAt" type="string | null" />

    <ResponseField name="createdAt" type="string" />

    <ResponseField name="shareToken" type="string">Plain token, re-exposed for copy-link rows.</ResponseField>
    <ResponseField name="clickCount" type="number">Recipient `viewed` events attributed to this share.</ResponseField>
    <ResponseField name="shareUrl" type="string">`{shareBase}/share/{shareToken}`.</ResponseField>
  </Expandable>
</ResponseField>

## Errors

| Status | code           | Meaning                                       |
| ------ | -------------- | --------------------------------------------- |
| 401    | `unauthorized` | Missing/invalid/revoked key.                  |
| 404    | `not_found`    | No render with that id in this key's project. |

```bash cURL theme={null}
curl https://api.craftkit.dev/v1/renders/$RENDER_ID/shares \
  -H "Authorization: Bearer $CRAFTKIT_API_KEY"
```

```json 200 theme={null}
{
  "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_…"
    }
  ]
}
```