---
title: "Get a single gallery template"
method: GET
path: "/v1/template-gallery/{slug}"
tags: ["Template Gallery"]
---

# Get a single gallery template

`GET /v1/template-gallery/{slug}`

## Request

- Base URL: `https://api.signvoy.com`
- URL: `https://api.signvoy.com/v1/template-gallery/{slug}`
- Auth: one of:
  - API key in header `X-Workspace-Id`
  - HTTP bearer

Includes the full normalized `content` so the client can render the template itself, plus a short-lived presigned PDF preview URL for `sourceKind: 'pdf'` templates only.

## Path parameters

- `slug` string, required

## Response `200`

- GalleryTemplateDto
  - `id` string, uuid, required
  - `slug` string, required: Stable URL-safe identifier
  - `name` string, required
  - `description` string, required
  - `category` string, required
  - `tags` string[], required
  - `fileName` string, required
  - `pageCount` integer, required: Page count of the seed PDF. Meaningful only for `sourceKind: 'pdf'` — a document-source template has no fixed page count until it is frozen at publish.
  - `planTier` string, required
  - `sortOrder` integer, required
  - `sourceKind` 'pdf' | 'document', required: `document` for content-native rich-text templates, `pdf` for templates built on an uploaded file.
  - `recipients` GalleryRecipientDto[], required: Signers, with the colours their fields are drawn in.
    - `key` string, required: Stable key referenced by `field.recipientKey`
    - `name` string, required
    - `color` string, required: Hex colour, e.g. `#2563EB`
    - `order` integer, required: Signing order (0-based)
  - `fieldCount` integer, required: Total fields across all pages
  - `previewUrl` string: Short-lived presigned URL for the seed PDF. Only present on the detail response and only for `sourceKind: 'pdf'` — document templates are rendered client-side from `content.body`.
  - `content` object: Full normalized template content: recipients, fields, rules, and (for document source) the rich-text body. Detail response only.

## Other responses

- `404`: Not found.

---

[API](https://skmtc.dev/signvoy/apis/signvoy-api.md) · [All operations](https://skmtc.dev/signvoy/apis/signvoy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signvoy/apis/signvoy-api/revisions/003cabc7cfe2?raw)
