---
title: "Get doc group template info"
url: "https://docs.signnow.com/docs/document-group-template/operations/get-document-group-template-info"
type: "endpoint"
section: "document-group-template"
slug: "document-group-template/operations/get-document-group-template-info"
method: "GET"
path: "/v2/document-group-templates/{document_group_template_id}"
operation_id: "get-document-group-template-info"
authorization: "bearer"
---

# Get doc group template info

`GET /v2/document-group-templates/{document_group_template_id}`

This endpoint allows API users to retrieve information about a specific document group template, including its documents, the roles assigned to each document, and, optionally, the fields in each document.

Available to the document group template owner and to users the template is shared with.

**Notes**

* Use the `include` query parameter to add optional data to the response. Unknown values are ignored.
* With `?include=documents.fields`, each item in `documents` contains a `fields` array. Without it, the response doesn't include `fields`.
* The objects in `fields` have the same format as the `fields` array of [`GET /document/{document_id}`](/docs/document/operations/get-document). Template fields don't contain a `data` key. Default values set in the template, such as `prefilled_text` for text fields, are returned inside `json_attributes`.
* The response doesn't include dropdown options (`enumeration_options`) or checkbox groups (`checkbox_groups`). [`GET /document/{document_id}`](/docs/document/operations/get-document) returns them at the document level, so call it for each document that needs them.
* `roles` contains role names only. To get the signing order and other recipient settings, call [`GET /v2/document-group-templates/{document_group_template_id}/recipients`](/docs/document-group-template/operations/get-v2-document-group-templates-doc-group-template-id-recipients).
* To add or update fields, call [`PUT /document/{document_id}`](/docs/document/operations/edit-document) for each document.
* To work with a document in the template, call this endpoint to get the current document IDs right before you use them.
* For document groups, use [`GET /v2/document-groups/{document_group_id}`](/docs/document-group/operations/get-document-group-info-v2).

## Authorization

bearer

## Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `document_group_template_id` | string | Yes | ID of the document group template. |

## Query Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `include=documents.fields` | string | No | If used, each item in `documents` contains a `fields` array with the fields of that document. |

## Responses

### 200

- Request with correct token
- Request with `include=documents.fields`

**Example** (`Basic`)

```json
{
  "data": {
    "id": "1adf85e869f45799558ab737df1cff93bad1cd4e",
    "name": "Employee onboarding",
    "owner": {
      "id": "579233b2c479241523cba5e3af55d0f50f2d6414",
      "email": "owner@example.com"
    },
    "created": 1791365561,
    "updated": 1791366293,
    "documents": [
      {
        "id": "ee17560c8b77385b5bb8d8687820f9b82f3fdcdf",
        "roles": [
          {
            "name": "Signer 1"
          },
          {
            "name": "Signer 2"
          }
        ],
        "document_name": "Employment Agreement"
      },
      {
        "id": "ce9ed66d82df7ce028a8623498350e2fb4412132",
        "roles": [
          {
            "name": "Signer 2"
          }
        ],
        "document_name": "Payroll Details"
      },
      {
        "id": "7cfd024b513673d9b90b6432f97d06812fec5f2b",
        "roles": [],
        "document_name": "Company Logo"
      }
    ]
  }
}
```

**Example** (`With document fields`)

```json
{
  "data": {
    "id": "1adf85e869f45799558ab737df1cff93bad1cd4e",
    "name": "Employee onboarding",
    "owner": {
      "id": "579233b2c479241523cba5e3af55d0f50f2d6414",
      "email": "owner@example.com"
    },
    "created": 1791365561,
    "updated": 1791366293,
    "documents": [
      {
        "id": "ee17560c8b77385b5bb8d8687820f9b82f3fdcdf",
        "roles": [
          {
            "name": "Signer 1"
          },
          {
            "name": "Signer 2"
          }
        ],
        "fields": [
          {
            "id": "c09bb890b096f7306f688cc6d1dad34e7e52a223",
            "role": "Signer 1",
            "type": "text",
            "role_id": "956998ca9bda000121215a6242b5659c8b86915a",
            "field_id": null,
            "fulfiller": null,
            "element_id": null,
            "originator": "owner@example.com",
            "json_attributes": {
              "x": 219,
              "y": 123,
              "bold": false,
              "font": "Arial",
              "name": "Employee name",
              "size": 12,
              "align": "left",
              "color": "000000",
              "width": 328,
              "height": 21,
              "italic": false,
              "valign": "top",
              "required": true,
              "font_size": 8,
              "max_chars": 0,
              "max_lines": 0,
              "underline": false,
              "arrangement": "none",
              "page_number": 0,
              "prefilled_text": "Enter employee name here"
            },
            "field_request_id": null,
            "template_field_id": null,
            "field_request_canceled": null
          },
          {
            "id": "cf1126f67238bf3e85fcc8c8737b72e80ddcfddb",
            "role": "Signer 1",
            "type": "signature",
            "role_id": "956998ca9bda000121215a6242b5659c8b86915a",
            "field_id": null,
            "fulfiller": null,
            "element_id": null,
            "originator": "owner@example.com",
            "json_attributes": {
              "x": 54,
              "y": 531,
              "name": "Employee signature",
              "width": 231,
              "height": 27,
              "required": true,
              "page_number": 0,
              "allowed_types": [
                "type",
                "draw",
                "upload"
              ]
            },
            "field_request_id": null,
            "template_field_id": null,
            "field_request_canceled": null
          },
          {
            "id": "619aae029dda528253a6af0ba619b45baa1df115",
            "role": "Signer 2",
            "type": "text",
            "role_id": "27563652e18222021d20bf272406dcbdab76bbeb",
            "field_id": null,
            "fulfiller": null,
            "element_id": null,
            "originator": "owner@example.com",
            "json_attributes": {
              "x": 218,
              "y": 243,
              "bold": false,
              "font": "Arial",
              "name": "Manager name",
              "size": 12,
              "align": "left",
              "color": "000000",
              "width": 328,
              "height": 21,
              "italic": false,
              "valign": "top",
              "required": true,
              "font_size": 8,
              "max_chars": 0,
              "max_lines": 0,
              "underline": false,
              "arrangement": "none",
              "page_number": 0
            },
            "field_request_id": null,
            "template_field_id": null,
            "field_request_canceled": null
          }
        ],
        "document_name": "Employment Agreement"
      },
      {
        "id": "ce9ed66d82df7ce028a8623498350e2fb4412132",
        "roles": [
          {
            "name": "Signer 2"
          }
        ],
        "fields": [
          {
            "id": "adfec5772ae8932aa10896037b0779bec915015b",
            "role": "Signer 2",
            "type": "text",
            "role_id": "5ebd260849efd1ba3d6ff32b61753b3a8df6d693",
            "field_id": null,
            "fulfiller": null,
            "element_id": null,
            "originator": "owner@example.com",
            "json_attributes": {
              "x": 218,
              "y": 141,
              "bold": false,
              "font": "Arial",
              "name": "Bank account",
              "size": 12,
              "align": "left",
              "color": "000000",
              "width": 330,
              "height": 21,
              "italic": false,
              "valign": "top",
              "required": true,
              "font_size": 8,
              "max_chars": 0,
              "max_lines": 0,
              "underline": false,
              "arrangement": "none",
              "page_number": 0
            },
            "field_request_id": null,
            "template_field_id": null,
            "field_request_canceled": null
          },
          {
            "id": "547cd2ba3a17b483651496c5ba8c78f1789b5cbd",
            "role": "Signer 2",
            "type": "signature",
            "role_id": "5ebd260849efd1ba3d6ff32b61753b3a8df6d693",
            "field_id": null,
            "fulfiller": null,
            "element_id": null,
            "originator": "owner@example.com",
            "json_attributes": {
              "x": 52,
              "y": 549,
              "name": "Manager signature",
              "width": 231,
              "height": 27,
              "required": true,
              "page_number": 0,
              "allowed_types": [
                "type",
                "draw",
                "upload"
              ]
            },
            "field_request_id": null,
            "template_field_id": null,
            "field_request_canceled": null
          }
        ],
        "document_name": "Payroll Details"
      },
      {
        "id": "7cfd024b513673d9b90b6432f97d06812fec5f2b",
        "roles": [],
        "fields": [],
        "document_name": "Company Logo"
      }
    ]
  }
}
```

### 400

- Request with incorrect or missing token

**Example** (`Invalid token`)

```json
{
  "code": 1537,
  "error": "invalid_token"
}
```

### 404

- Document group template ID does not exist
- Document group template is not active
- User has no access to the document group template

**Example** (`Not found or no access`)

```json
{
  "errors": [
    {
      "code": 23001014,
      "message": "Document Group Template `c3d8d1f0e1a24b6e9f2a7b5c4d3e2f1a0b9c8d7e` not found"
    }
  ]
}
```

## Code Examples

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

### cURL

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

---
*Full reference: https://docs.signnow.com/docs/document-group-template/operations/get-document-group-template-info*