Retrieves a list of documents associated with the specified template.


HTTP request

GET /v2/accounts/{accountId}/templates/{templateId}/documents


Parameter name Value Description
Path parameters
accountId string

The external account number (int) or account ID Guid.

templateId string

The ID of the template being accessed.


Code Description Reference
200 OK Successful response.
400 Bad Request Error encountered.

SDK Method


Definitions Expand All | Collapse All


Template documents

templateId string

The unique identifier of the template. If this is not provided, DocuSign will generate a value.


attachmentTabId string
authoritativeCopy string

Specifies whether all documents in this envelope are authoritative copies. A document can set its own authoritativeCopy property to override this value.

containsPdfFormFields string
display string

This string sets the display and behavior properties of the document during signing. The possible values are:

  • modal
    The document is shown as a supplement action strip and can be viewed, downloaded, or printed in a modal window. This is the recommended value for supplemental documents.

  • download
    The document is shown as a supplement action strip and can be viewed, downloaded, or printed in a new browser window.

  • inline
    The document is shown in the normal signing window. This value is not used with supplemental documents, but is the default value for all other documents.

documentGroup string
documentId string

Specifies the document ID number that the tab is placed on. This must refer to an existing Document's ID attribute.

errorDetails errorDetails
includeInDownload string

When set to true, the document is included in the combined document download. The default value is true.

name string
order string

An optional value that sets the direction order used to sort the item list.

Valid values are:

  • asc = ascending sort order
  • desc = descending sort order
pages string
signerMustAcknowledge string

Sets how the signer interacts with the supplemental document. The possible values are:

  • no_interaction
    No recipient action is required.

  • view
    The recipient is required to view the document.

  • accept
    The recipient is required to accept the document by selecting accept during signing, but is not required to view the document.

  • view_accept
    The recipient is required to view and accept the document.

type string

Type of the user. Valid values: type_owner, type_participant.

uri string


This object describes errors that occur. It is only valid for responses, and ignored in requests.

errorCode string

An error code associated with the error.

message string

A short error message.


errorDetails errorDetails
name string

The name or key of a name/value pair.

originalValue string

The initial value of the tab when it was sent to the recipient.

value string

The value field of a name/value pair.


isDefault string
type string

Type of the user. Valid values: type_owner, type_participant.


Generic JSON Response


"templateId": "sample string 1",
"templateDocuments": [
"documentId": "sample string 1",
"name": "sample string 2",
"type": "sample string 3",
"uri": "sample string 4",
"order": "sample string 5",
"pages": "sample string 6",
"containsPdfFormFields": "sample string 7",
"documentFields": [
"availableDocumentTypes": [
"type": "sample string 1",
"isDefault": "sample string 2"
"attachmentTabId": "sample string 8",
"display": "sample string 9",
"includeInDownload": "sample string 10",
"signerMustAcknowledge": "sample string 11",
"documentGroup": "sample string 12",
"authoritativeCopy": "sample string 13",
"errorDetails": {
"errorCode": "sample string 1",
"message": "sample string 2"

Generic XML Response



<attachmentTabId>sample string 8</attachmentTabId>
<authoritativeCopy>sample string 13</authoritativeCopy>
<isDefault>sample string 2</isDefault>
<type>sample string 1</type>
<containsPdfFormFields>sample string 7</containsPdfFormFields>
<display>sample string 9</display>
<nameValue />
<documentGroup>sample string 12</documentGroup>
<documentId>sample string 1</documentId>
<errorCode>sample string 1</errorCode>
<message>sample string 2</message>
<includeInDownload>sample string 10</includeInDownload>
<name>sample string 2</name>
<order>sample string 5</order>
<pages>sample string 6</pages>
<signerMustAcknowledge>sample string 11</signerMustAcknowledge>
<type>sample string 3</type>
<uri>sample string 4</uri>
<templateId>sample string 1</templateId>