---
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`

This endpoint allows API users to get the pinned templates in the `Templates` folder or one of its subfolders.

**Notes**

* `folder_id` must be the ID of the `Templates` folder or one of its subfolders. For any other folder, the endpoint returns `400`.
* To get the ID of the `Templates` folder, call `GET /user/folder`.

## Authorization

bearer

## Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `folder_id` | string | Yes | ID of the `Templates` folder or one of its subfolders. |

## Responses

### 200

The pinned templates in the folder. `data` is empty if no templates are pinned.

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

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

```json
{
  "data": [
    {
      "id": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0",
      "tags": [
        {
          "name": "fields",
          "type": "system",
          "unique_id": "d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3"
        },
        {
          "name": "field_signature",
          "type": "system",
          "unique_id": "e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4"
        },
        {
          "name": "template",
          "type": "system",
          "unique_id": "f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5"
        }
      ],
      "owner": "user@example.com",
      "roles": [
        {
          "name": "Role 1",
          "unique_id": "c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2",
          "signing_order": 1
        }
      ],
      "created": 1792405293,
      "updated": 1792405294,
      "user_id": "b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1",
      "thumbnail": {
        "large": "https://api.signnow.com/document/a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0/thumbnail?size=large",
        "small": "https://api.signnow.com/document/a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0/thumbnail?size=small",
        "medium": "https://api.signnow.com/document/a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0/thumbnail?size=medium"
      },
      "page_count": 1,
      "signatures": [],
      "attachments": [],
      "version_time": 1792405294,
      "viewer_roles": [],
      "document_name": "Purchase order terms",
      "recently_used": 1792405294,
      "routing_details": [
        {
          "cc": [],
          "id": "a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6",
          "data": [
            {
              "name": "Role 1",
              "role_id": "c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2",
              "attributes": [],
              "inviter_role": false,
              "default_email": "signer@example.com",
              "signing_order": 1,
              "decline_by_signature": false
            }
          ],
          "cc_step": [],
          "created": 1792405294,
          "updated": 1792405294,
          "viewers": [],
          "approvers": [],
          "invite_link_instructions": null
        }
      ],
      "original_filename": "purchase-order-terms.pdf",
      "document_group_template_info": []
    }
  ],
  "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
{
  "errors": [
    {
      "code": 13033002,
      "message": "User folder `a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0` 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
{
  "errors": [
    {
      "code": 13033001,
      "message": "User is not owner of the `a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0` user folder."
    }
  ]
}
```

### 404

The folder does not exist.

**Example** (`Folder not found`)

```json
{
  "errors": [
    {
      "message": "UserFolder `a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0` not found"
    }
  ]
}
```

## 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*