---
title: "Get pinned templates"
url: "https://docs.signnow.com/docs/folder/operations/get-v2-folders-folder_id-document-templates-pinned"
type: "endpoint"
section: "folder"
slug: "folder/operations/get-v2-folders-folder_id-document-templates-pinned"
method: "GET"
path: "/v2/folders/{folder_id}/document-templates/pinned"
operation_id: "get-v2-folders-folder_id-document-templates-pinned"
authorization: "bearer"
---

# Get pinned templates

`GET /v2/folders/{folder_id}/document-templates/pinned`

The endpoint is used to retrieve a list of pinned templates in the Templates folder.

## Authorization

bearer

## Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `folder_id` | string | Yes | ID of the template folder. |

## Header Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `Content-Type` | string | No | application/json |

## Responses

### 200

* User has 1 pinned template
* User has no pinned templates

**Example** (`User has 1 pinned template`)

```json
{
  "data": [
    {
      "id": "",
      "tags": [
        {
          "name": "",
          "type": "",
          "unique_id": ""
        }
      ],
      "owner": "",
      "roles": [
        {
          "name": "",
          "unique_id": "",
          "signing_order": ""
        }
      ],
      "created": "",
      "updated": "",
      "user_id": "",
      "thumbnail": {
        "large": "",
        "small": "",
        "medium": ""
      },
      "page_count": "",
      "signatures": [
        {
          "x": "",
          "y": "",
          "id": "",
          "email": "",
          "width": "",
          "height": "",
          "created": "",
          "subtype": "",
          "user_id": "",
          "page_number": "",
          "signature_request_id": ""
        }
      ],
      "attachments": [
        {
          "x": "",
          "y": "",
          "id": "",
          "width": "",
          "height": "",
          "created": "",
          "user_id": "",
          "filename": "",
          "file_size": "",
          "file_type": "",
          "mime_type": "",
          "line_height": "",
          "page_number": "",
          "json_attributes": null,
          "original_attachment_name": ""
        }
      ],
      "version_time": "",
      "viewer_roles": [
        {
          "name": "",
          "unique_id": "",
          "signing_order": ""
        }
      ],
      "document_name": "",
      "routing_details": [
        {
          "cc": {},
          "id": "",
          "data": {},
          "cc_step": {},
          "created": "",
          "updated": "",
          "viewers": {},
          "invite_link_instructions": {}
        }
      ],
      "original_filename": "",
      "document_group_template_info": [
        {
          "id": "",
          "shared": "",
          "created": "",
          "updated": "",
          "template_group_name": ""
        }
      ]
    }
  ],
  "meta": {
    "pagination": {
      "count": 1,
      "links": [],
      "total": 1,
      "per_page": 15,
      "total_pages": 1,
      "current_page": 1
    }
  }
}
```

**Example** (`User has no pinned templates`)

```json
{
  "data": [],
  "meta": {
    "pagination": {
      "count": 0,
      "links": [],
      "total": 0,
      "per_page": 15,
      "total_pages": 1,
      "current_page": 1
    }
  }
}
```

### 400

User folder {folder_id} is not Template folder or Template sub-folder

**Example** (`User folder {folder_id} is not Template folder or Template sub-folder`)

```json
{
  "code": 13033002,
  "message": "User folder `11XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX` is not Template folder or Template sub-folder."
}
```

### 403

Folder {folder_id} doesn’t belong to a user

**Example** (`Folder {folder_id} doesn’t belong to a user`)

```json
{
  "code": 13033001,
  "message": "User is not owner of the `11XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX` user folder."
}
```

## Code Examples

> Replace `$SIGNNOW_ACCESS_TOKEN` and any `{placeholder}` values before running.

### cURL

```bash
curl -X GET \
  "https://api.signnow.com/v2/folders/{folder_id}/document-templates/pinned" \
  -H "Authorization: Bearer $SIGNNOW_ACCESS_TOKEN"
```

---
*Full reference: https://docs.signnow.com/docs/folder/operations/get-v2-folders-folder_id-document-templates-pinned*