# Get Template Sharing

> Get the public sharing state, links and stats for a studio template

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

---

## Overview

Returns the current public sharing state of a studio template, including the public link, embed link, ready-to-paste embed code, and view/copy stats. These are the same links you see in the studio's Share dialog.```markdown tab="Endpoint"
https://api.orshot.com/v1/studio/templates/:templateId/share
```## Path Parameters

| Parameter    | Type    | Required | Description                              |
| ------------ | ------- | -------- | ---------------------------------------- |
| `templateId` | Integer | Yes      | The unique ID of the studio template     |

## Request```js
await fetch("https://api.orshot.com/v1/studio/templates/123/share", {
  method: "GET",
  headers: {
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});
```</Tab>```json
{
  "enabled": true,
  "allow_duplication": true,
  "share_url": "https://orshot.com/templates/shared/k3n9xq2w/preview?view=view",
  "embed_url": "https://orshot.com/templates/shared/k3n9xq2w/embed?view=view",
  "embed_code": "<iframe src=\"https://orshot.com/templates/shared/k3n9xq2w/embed?view=view\" title=\"Orshot Embed\" allow=\"clipboard-write\" style=\"width: 100%; height: 100%; min-height: 500px; border: none; border-radius: 8px;\"></iframe>",
  "stats": {
    "views": 42,
    "copies": 3
  },
  "created_at": "2026-07-11T08:05:18.491Z"
}
```</Tab>
</Tabs>

When sharing is disabled, `enabled` is `false` and the link fields are `null`.

## Response Fields

| Field               | Type    | Description                                                          |
| ------------------- | ------- | -------------------------------------------------------------------- |
| `enabled`           | Boolean | Whether public sharing is on                                          |
| `allow_duplication` | Boolean | Whether visitors can save a copy of the template to their workspace   |
| `share_url`         | String  | Public preview link (`null` when sharing is off)                      |
| `embed_url`         | String  | Embeddable page link (`null` when sharing is off)                     |
| `embed_code`        | String  | Ready-to-paste iframe snippet (`null` when sharing is off)            |
| `stats.views`       | Integer | How many times the public page was viewed                             |
| `stats.copies`      | Integer | How many times the template was duplicated from the public page       |
| `created_at`        | String  | When sharing was first enabled                                        |

## Error Responses

### Template Not Found (404)```json
{
  "error": "Studio template with ID '123' not found in your workspace"
}
```### Unauthorized (403)```json
{
  "error": "Access Forbidden: Invalid API Key"
}
```## Rate Limits

- 30 requests per minute per API key