List a deck's shares

GET/v1/shares

Lists the share tokens for a deck (newest first), including revoked ones.

Requires an API key (bearer), scoped to the active org.

Query parameters

deckstringrequired

Returns

200The deck's shares.

Failures use the standard error envelope with a closed set of codes.

Terminal

renza shares list <deck>

GET /v1/shares

curl https://api.renza.io/v1/shares \
  -H "Authorization: Bearer $RENZA_API_KEY"

TypeScript

import { createRenzaClient } from "renza-sdk";

const renza = createRenzaClient({ apiKey: process.env.RENZA_API_KEY! });

const page = await renza.shares.list("deck_2a9f8c1b");

Response 200

{
  "object": "list",
  "url": "/v1/decks",
  "data": [
    {
      "id": "shr_7a2c…",
      "object": "share",
      "token": "X3k9...x",
      "deck": "deck_2a9f8c1b",
      "mode": "link",
      "url": "https://renza.io/v/X3k9…x",
      "expires_at": null,
      "revoked_at": null,
      "created_at": "2026-06-19T10:30:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}