---
title: "Get doc groups created from template"
method: GET
path: "/v2/document-group-templates/{doc_group_template_id}/copies"
---

# Get doc groups created from template

`GET /v2/document-group-templates/{doc_group_template_id}/copies`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/v2/document-group-templates/{doc_group_template_id}/copies`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/v2/document-group-templates/:doc_group_template_id/copies/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows API users to retrieve all document groups created and sent from a specific document group template. Use query parameters to filter, sort, paginate the results, or search for specific search keys.

## Response `200`

Successful response. Returns the document groups created from the document group template, with pagination details. Use the query parameters to filter, sort, and paginate the results.

- object
  - `data` object[]: Document groups created from the document group template.
    - `id` string: ID of the document group.
    - `owner` string: Email address of the document group owner.
    - `state` string: State of the document group, for example `created`, `pending`, or `fulfilled`.
    - `created` integer: Unix timestamp of when the document group was created.
    - `invites` object[]: Invite actions of the document group invite, one per recipient and document.
      - `id` string: ID of the invite action. `null` if not available.
      - `email` string: Email address of the recipient.
      - `order` integer: Step of the invite in which the recipient receives it.
      - `action` string: Action the recipient must perform: `sign`, `view`, or `approve`.
      - `status` string: Status of the invite action: `pending` or `fulfilled`.
      - `created` integer: Unix timestamp of when the invite action was created.
      - `updated` integer: Unix timestamp of the last update of the invite action.
      - `compliance` object: Compliance settings of the invite.
        - `cfr` string: 21 CFR Part 11 settings of the invite. `null` if not applied.
      - `document_id` string: ID of the document.
      - `email_group` object: Email group the invite was sent to. `id` and `name` are `null` if the invite was sent to a single recipient.
        - `id` string: ID of the email group. `null` if the invite was sent to a single recipient.
        - `name` string: Name of the email group. `null` if the invite was sent to a single recipient.
      - `is_embedded` boolean: `true` if the invite is an embedded invite.
      - `document_name` string: Name of the document.
      - `authentication` string: Authentication settings of the recipient. `null` if not set.
      - `signature_type` string: Type of signature required from the recipient. `null` if not set.
      - `expiration_time` integer: Unix timestamp of when the invite expires. `null` if not set.
      - `is_draft_exists` boolean: `true` if the recipient saved a draft.
      - `password_method` string: Method used to deliver the invite password. Empty if no password is set.
      - `payment_request` string: Payment request attached to the invite action. `null` if there is none.
      - `is_full_declined` boolean: `true` if the recipient declined the invite.
      - `sms_sent_statuses` unknown[]: SMS delivery events of the invite. Empty for email invites.
        - unknown
      - `is_document_locked` string: `"1"` if the document is locked for this recipient, otherwise `"0"`.
      - `password_protected` string: `"1"` if the invite is password-protected, otherwise `"0"`.
      - `email_sent_statuses` object[]: Email delivery events of the invite. Each object is one event.
        - `status` string: Email delivery status, for example `sent` or `delivered`.
        - `created_at` integer: Unix timestamp of when the event was recorded.
        - `last_reaction_at` integer: Unix timestamp of the last update of the event.
      - `signer_phone_invite` string: Phone number the SMS invite was sent to. `null` for email invites.
    - `updated` integer: Unix timestamp of the last update of the document group.
    - `user_id` string: ID of the document group owner.
    - `documents` object[]: Documents in the document group.
      - `id` string: ID of the document.
      - `name` string: Name of the document.
      - `roles` string[]: Roles assigned in the document. Empty if the document has no roles.
      - `updated` integer: Unix timestamp of the last update of the document.
      - `settings` object: Settings of the document.
        - `advanced_signing_flow` boolean: `true` if the advanced signing flow is enabled for the document.
      - `thumbnail` object: Thumbnail URLs of the first page of the document.
        - `large` string: URL of the large thumbnail.
        - `small` string: URL of the small thumbnail.
        - `medium` string: URL of the medium thumbnail.
      - `has_fields` boolean: `true` if the document has fillable fields.
      - `page_count` integer: Number of pages in the document.
      - `signatures` unknown[]: Signatures added to the document.
        - unknown
    - `invite_id` string: ID of the active document group invite. `null` if no invite was sent.
    - `parent_id` string: ID of the folder that contains the document group.
    - `is_favorite` boolean: `true` if the document group is marked as a favorite.
    - `entity_labels` unknown[]: Labels assigned to the document group, for example when an invite email could not be delivered. Empty if there are none.
      - unknown
    - `own_as_merged` boolean: `true` if the document group was created from a merged document group template.
    - `recently_used` integer: Unix timestamp of the last activity on the document group.
    - `sign_as_merged` boolean: `true` if the documents in the group are signed as one merged document.
    - `freeform_actions` object[]: FreeForm invite actions of the document group.
    - `freeform_invite_id` string: ID of the FreeForm invite. `null` if none was sent.
    - `document_group_name` string: Name of the document group.
  - `meta` object: Pagination details.
    - `pagination` object: Pagination details.
      - `count` integer: Number of items on the current page.
      - `links` object: Links to the adjacent pages. An empty array if there are no other pages.
        - `next` string: URL of the next page. Returned only if there is a next page.
        - `previous` string: URL of the previous page. Returned only if there is a previous page.
      - `total` integer: Total number of items.
      - `per_page` integer: Maximum number of items per page.
      - `total_pages` integer: Total number of pages.
      - `current_page` integer: Number of the current page.

## Other responses

- `400`: * Wrong, expired, or missing token. * The `page` parameter type is incorrect. * The `page` parameter value is incorrect. * The `per_page` parameter type is incorrect. * The `per_page` parameter value is incorrect. * The `sort_by` parameter value is incorrect. * The `sort_order` parameter value is incorrect. * The `filters[signing_status]` parameter value or format is incorrect. * The `filters` field value is incorrect. * The `per_page` parameter exceeds the maximum allowed value.
- `403`: The user is not the document group template owner.
- `404`: Document group template ID doesn't exist.

---

[API](https://skmtc.dev/signnow/apis/signnow-api.md) - [All operations](https://skmtc.dev/signnow/apis/signnow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signnow/apis/signnow-api/revisions/1c9c30a6142b?raw)