# Get Template Version

> One version of a studio template, optionally with its full design

- **URL**: https://orshot.com/docs/api-reference/template-version-get

---

Version history endpoints are available to first party clients like the
[Orshot MCP server](https://orshot.com/agents) and workspaces on the
Enterprise plan. Checkout the [Enterprise
Pricing](https://orshot.com/pricing) to get access.

Returns one version. Add `?snapshot=true` to include the stored design (name, description, tags, canvas and `pages_data`), for example to diff two versions or to read an old value back.

## Endpoint

```markdown tab="Endpoint"
https://api.orshot.com/v1/studio/templates/:templateId/versions/:versionId
```

## URL Parameters

| Parameter    | Type    | Required | Description               |
| ------------ | ------- | -------- | ------------------------- |
| `templateId` | Integer | Yes      | ID of the studio template |
| `versionId`  | Integer | Yes      | ID of the version         |

## Query Parameters

| Parameter  | Type    | Required | Default | Description                                  |
| ---------- | ------- | -------- | ------- | -------------------------------------------- |
| `snapshot` | Boolean | No       | `false` | Include the stored design under `snapshot`   |

## Request

**Request**
```js
await fetch(
  "https://api.orshot.com/v1/studio/templates/12345/versions/57?snapshot=true",
  { headers: { Authorization: "Bearer <ORSHOT_API_KEY>" } },
);
```

**Response**
```json
{
  "version": {
    "id": 57,
    "number": 12,
    "kind": "named",
    "label": "Approved for launch",
    "protected": true,
    "row_updated_at": "2026-09-15T11:31:19.576+00:00",
    "page_count": 3
  },
  "snapshot": {
    "v": 1,
    "name": "Launch banner",
    "description": "",
    "tags": "[\"launch\"]",
    "thumbnail_mode": "auto",
    "canvas_width": 1200,
    "canvas_height": 630,
    "canvas_data": { "width": 1200, "height": 630 },
    "elements_data": [],
    "pages_data": [{ "id": "p1", "name": "Cover", "elements": [ "…" ] }],
    "context": { "folder_id": null, "public_sharing_enabled": false }
  }
}
```

## Error Responses

| Status Code | Code                   | Description                                            |
| ----------- | ---------------------- | ------------------------------------------------------ |
| 400         | `invalid_template_id`  | `templateId` is not a numeric id                       |
| 400         | `invalid_version_id`   | `versionId` is not a numeric id                        |
| 400         | `invalid_query`        | `snapshot` is not `true` or `false`                    |
| 403         | `enterprise_required`  | API key without the Enterprise version history feature |
| 404         | `VERSION_NOT_FOUND`    | No such version on this template                       |
| 422         | `SNAPSHOT_UNREADABLE`  | The stored design could not be decoded                 |