DocuSign: Esignature schemas (part 19)
24 DocuSign schemas with complete fields and constraints.
← Esignature operations · All schemas
Gets a BCC email archive configuration and its history — response body — bcc Email Archive History item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Contains details about the history of the BCC email archive configuration. |
accountId | string | Optional | The ID of the account that owns the BCC email archive configuration. |
action | string | Optional | The action taken on the BCC email archive configuration. Examples: - `CREATED`: The BCC email archive configuration has been created. - `UPDATED`: The BCC email address has been activated by clicking on the activation link in the activation email message. - `CLOSED`: The BCC email address has been marked as closed is no longer used for archiving. |
email | string | Optional | The BCC email address used to archive the emails that Docusign generates. Example: customer_bcc@example.com |
modified | string | Optional | The UTC DateTime when the BCC email address was last modified. |
modifiedBy | Model | Optional | Expand Gets a specific template associated with a specified account — response body — owner Details about the user who last modified the BCC email archive configuration. |
status | string | Optional | The status of the BCC email address. Possible values are: - `activation_sent`: An activation link has been sent to the BCC email address. - `active`: The BCC email address is actively used for archiving. - `closed`: The BCC email address is no longer used for archiving. |
Referenced models: Gets a specific template associated with a specified account — response body — owner
Gets a Connect log entry — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Contains information about a Connect log entry. |
accountId | string | Optional | The account ID associated with the envelope. |
configUrl | string | Optional | The web address of the listener or retrieving service endpoint for Connect. |
connectDebugLog | array | Optional | A complex element containing information about the Connect configuration, error details, date/time, description and payload. This information is included in the response only when the `additional_info` query is set to **true.** This additional information is only available when retrieving general logs with [ConnectEvents:get](/docs/esign-rest-api/reference/connect/connectevents/get/), but not when retrieving failure logs with [ConnectEvents:listFailures](/docs/esign-rest-api/reference/connect/connectevents/listfailures/). |
connectDebugLog[] | Model | Each item | Expand Gets a Connect log entry — response body — connect Debug Log item |
connectId | string | Optional | The ID of the Connect configuration that failed. If an account has multiple Connect configurations, this value is used to look up the Connect configuration for the failed post. |
created | string | Optional | The UTC DateTime when the Connect post was created. |
email | string | Optional | The email address of the envelope sender. |
envelopeId | string | Optional | The ID of the envelope that failed to post. |
error | string | Optional | The error that caused the Connect post to fail. |
failureId | string | Optional | The failure log ID for the failure. |
failureUri | string | Optional | The URI for the Connect post failure. |
lastTry | string | Optional | The UTC DateTime of the last attempt to post. |
logId | string | Optional | The Connect log ID for the entry. |
logUri | string | Optional | The URI for the Connect log entry. |
retryCount | string | Optional | The number of times the Connect post has been retried. |
retryUri | string | Optional | A URI that you can use to retry to publish the Connect post. |
status | string | Optional | The envelope status for the Connect post. Possible values are: - `Any` - `Voided` - `Created` - `Deleted` - `Sent` - `Delivered` - `Signed` - `Completed` - `Declined` - `TimedOut` - `Template` - `Processing` For details about these statuses, see [Envelope Status Code Descriptions](/docs/esign-rest-api/esign101/rules-and-limits/responses/). |
subject | string | Optional | The subject of the envelope. |
userName | string | Optional | The name of the sender of the envelope. |
Referenced models: Gets a Connect log entry — response body — connect Debug Log item
Gets a Connect log entry — response body — connect Debug Log item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
connectConfig | string | Optional | The name of the Connect configuration. |
errorDetails | Model | Optional | Expand Locks a template — response body — error Details This object describes errors that occur. It is only valid for responses and ignored in requests. |
eventDateTime | string | Optional | The UTC date and time of the event. |
eventDescription | string | Optional | A description of the event. |
payload | string | Optional | Log output. |
Referenced models: Locks a template — response body — error Details
Gets a list of all account tabs — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
tabs | array | Optional | A list of tabs, which are represented graphically as symbols on documents at the time of signing. Tabs show recipients where to sign, initial, or enter data. They may also display data to the recipients. |
tabs[] | Model | Each item | Expand Creates a custom tab — response body |
Referenced models: Creates a custom tab — response body
Gets a list of available billing plans — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Defines a billing plans response object. |
billingPlans | array | Optional | Reserved for Docusign. |
billingPlans[] | Model | Each item | Expand Gets billing plan details — response body — billing Plan |
Referenced models: Gets billing plan details — response body — billing Plan
Gets a list of brands — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | The AccountBrands resource enables you to use account-level brands to customize the styles and text that recipients see. |
brands | array | Optional | A list of brands. |
brands[] | Model | Each item | Expand Updates an existing brand — response body |
recipientBrandIdDefault | string | Optional | The brand that envelope recipients see when a brand is not explicitly set. |
senderBrandIdDefault | string | Optional | The brand that envelope senders see when a brand is not explicitly set. |
Referenced models: Updates an existing brand — response body
Gets a list of custom fields — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | An `accountCustomField` is an envelope custom field that you set at the account level. Applying custom fields enables account administrators to group and manage envelopes. |
listCustomFields | array | Optional | An array of list custom fields. |
listCustomFields[] | Model | Each item | Expand Gets a list of custom fields — response body — list Custom Fields item |
textCustomFields | array | Optional | An array of text custom fields. |
textCustomFields[] | Model | Each item | Expand Gets a list of custom fields — response body — text Custom Fields item |
Referenced models: Gets a list of custom fields — response body — list Custom Fields item, Gets a list of custom fields — response body — text Custom Fields item
Gets a list of custom fields — response body — list Custom Fields item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | This object represents a list custom field from which envelope creators and senders can select custom data. |
configurationType | string | Optional | If you are using merge fields, this property specifies the type of the merge field. The only supported value is `salesforce`. |
errorDetails | Model | Optional | Expand Locks a template — response body — error Details This object describes errors that occur. It is only valid for responses and ignored in requests. |
fieldId | string | Optional | The ID of the custom field. |
listItems | array | Optional | An array of strings that represents the options in a list. Maximum length: 2048 characters, but each individual option string can only be a maximum of 100 characters. |
listItems[] | string | Each item | |
name | string | Optional | The name of the custom field. |
required | string | Optional | When **true,** senders are required to select an option from the list before they can send the envelope. |
show | string | Optional | When **true,** the field displays in the **Envelope Custom Fields** section when a user creates or sends an envelope. |
value | string | Optional | The value of the custom field. This is the value that the user who creates or sends the envelope selects from the list. |
Referenced models: Locks a template — response body — error Details
Gets a list of custom fields — response body — text Custom Fields item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | This object represents a free text custom field where envelope creators and senders can enter custom data. |
configurationType | string | Optional | If you are using merge fields, this property specifies the type of the merge field. The only supported value is `salesforce`. |
errorDetails | Model | Optional | Expand Locks a template — response body — error Details This object describes errors that occur. It is only valid for responses and ignored in requests. |
fieldId | string | Optional | The ID of the custom field. |
name | string | Optional | The name of the custom field. |
required | string | Optional | When **true,** senders are required to enter or select information for the field before they can send the envelope. |
show | string | Optional | When **true,** the field displays in the **Envelope Custom Fields** section when a user creates or sends an envelope. |
value | string | Optional | The value of the custom field. The user who creates or sends the envelope provides this value. Maximum length: 100 characters. |
Referenced models: Locks a template — response body — error Details
Gets a list of items from a cloud storage provider — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
endPosition | string | Optional | The last index position in the result set. |
errorDetails | Model | Optional | Expand Gets a list of items from a cloud storage provider — response body — error Details This object describes errors that occur. It is only valid for responses and ignored in requests. |
id | string | Optional | A unique ID for the Salesforce object. |
items | array | Optional | If the tab is a list, this represents the values that are possible for the tab. |
items[] | Model | Each item | Expand Gets a list of items from a cloud storage provider — response body — items item |
name | string | Optional | |
nextUri | string | Optional | The URI for the next chunk of records based on the search request. It is `null` if this is the last set of results for the search. |
previousUri | string | Optional | The URI for the prior chunk of records based on the search request. It is `null` if this is the first set of results for the search. |
resultSetSize | string | Optional | The number of results in this response. Because you can filter which entries are included in the response, this value is always less than or equal to the `totalSetSize`. |
skyDriveSkipToken | string | Optional | |
startPosition | string | Optional | The starting index position of the current result set. |
totalSetSize | string | Optional | The total number of items in the result set. This value is always greater than or equal to the value of `resultSetSize`. |
Referenced models: Gets a list of items from a cloud storage provider — response body — error Details, Gets a list of items from a cloud storage provider — response body — items item
Gets a list of items from a cloud storage provider — response body — error Details
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
authenticationUrl | string | Optional | Reserved for Docusign. |
errorCode | string | Optional | A code associated with the error condition. |
message | string | Optional |
Gets a list of items from a cloud storage provider — response body — items item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | This object contains information about a file or folder in cloud storage. |
date | string | Optional | The UTC date and time that the file or folder was last modified. |
hasCompositeTemplate | string | Optional | |
id | string | Optional | The storage provider's ID for the file or folder. |
img | string | Optional | The file extension for a file. **Note:** If the item is a folder, this value is null. |
name | string | Optional | The full name of a file. |
ownerName | string | Optional | |
size | string | Optional | The size of the file. The file size limit varies based on the cloud storage provider. |
supported | string | Optional | When **true,** Docusign supports the file type for upload. |
type | string | Optional | The type of cloud storage item. Valid values are: - `file` - `folder` |
uri | string | Optional | The URI for the file or folder. |
Gets a list of permission profiles — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Contains details about the permission profiles associated with an account. |
permissionProfiles | array | Optional | A complex type containing a collection of permission profiles. |
permissionProfiles[] | Model | Each item | Expand Returns a permission profile for an account — response body |
Referenced models: Returns a permission profile for an account — response body
Gets a list of unsupported file types — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
fileTypes | array | Optional | A collection of file types. |
fileTypes[] | Model | Each item | Expand Gets a list of unsupported file types — response body — file Types item |
Referenced models: Gets a list of unsupported file types — response body — file Types item
Gets a list of unsupported file types — response body — file Types item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
fileExtension | string | Optional | |
mimeType | string | Optional | The mime-type of a file type listed in a fileTypes collection. |
Gets a list of users in a group — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
endPosition | string | Optional | The last index position in the result set. |
nextUri | string | Optional | The URI for the next chunk of records based on the search request. It is `null` if this is the last set of results for the search. |
previousUri | string | Optional | The URI for the prior chunk of records based on the search request. It is `null` if this is the first set of results for the search. |
resultSetSize | string | Optional | The number of results in this response. Because you can filter which entries are included in the response, this value is always less than or equal to the `totalSetSize`. |
startPosition | string | Optional | The starting index position of the current result set. |
totalSetSize | string | Optional | The total number of items in the result set. This value is always greater than or equal to the value of `resultSetSize`. |
users | array | Optional | User management information. |
users[] | Model | Each item | Expand Gets a list of users in a group — response body — users item |
Referenced models: Gets a list of users in a group — response body — users item
Gets a list of users in a group — response body — users item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
activationAccessCode | string | Optional | Access code provided to the user to activate the account. |
email | string | Optional | |
errorDetails | Model | Optional | Expand Locks a template — response body — error Details This object describes errors that occur. It is only valid for responses and ignored in requests. |
loginStatus | string | Optional | Boolean value that indicates whether the user is currently logged in or not. |
sendActivationEmail | string | Optional | This field is no longer supported for most accounts. To create an eSignature user without sending an activation email, use the Admin API by following [these steps](/docs/admin-api/how-to/create-active-user/). |
uri | string | Optional | A URI containing the user ID. |
userId | string | Optional | The ID of the user to access. **Note:** Users can only access their own information. A user, even one with Admin rights, cannot access another user's settings. |
userName | string | Optional | The name of the user. |
userStatus | string | Optional | Status of the user's account. One of: - `ActivationRequired` - `ActivationSent` - `Active` - `Closed` - `Disabled` |
userType | string | Optional | The type of user, for example `CompanyUser`. |
Referenced models: Locks a template — response body — error Details
Gets a specific template associated with a specified account — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
accessControlListBase64 | string | Optional | Reserved for Docusign. |
allowComments | string | Optional | When **true,** users can add comments to the documents in the envelope. For example, if a signer has a question about the text in the document, they can add a comment to the document. |
allowMarkup | string | Optional | When **true,** the Document Markup feature is enabled. **Note:** To use this feature, Document Markup must be enabled at both the account and envelope levels. Only Admin users can change this setting at the account level. |
allowReassign | string | Optional | When **true,** the recipient can redirect an envelope to a more appropriate recipient. |
allowViewHistory | string | Optional | When **true,** recipients can view the history of the envelope. |
anySigner | string | Optional | Deprecated. This feature has been replaced by signing groups. |
asynchronous | string | Optional | When **true,** the envelope is queued for processing and the value of the `status` property is set to `Processing`. Additionally, GET status calls return `Processing` until completed. **Note:** A `transactionId` is required for this call to work correctly. When the envelope is created, the status is `Processing` and an `envelopeId` is not returned in the response. To get the `envelopeId`, use a GET envelope query by using the [transactionId](/docs/esign-rest-api/reference/envelopes/envelopes/create/) or by checking the Connect notification. |
attachmentsUri | string | Optional | Contains a URL for retrieving the attachments that are associated with the envelope. |
authoritativeCopy | string | Optional | When **true,** marks all of the documents in the envelope as authoritative copies. **Note:** You can override this value for a specific document. For example, you can set the `authoritativeCopy` property to **true** at the envelope level, but turn it off for a single document by setting the `authoritativeCopy` property for the document to **false.** |
authoritativeCopyDefault | string | Optional | The default `authoritativeCopy` setting for documents in this envelope that do not have `authoritativeCopy` set. If this property is not set, each document defaults to the envelope's `authoritativeCopy`. |
autoMatch | string | Optional | By default, templates that have been used within the last 60 days are included in auto-matching. By explicitly setting `autoMatch`, you can permanently include or exclude the template in auto matching. When **true** the template is included in auto-matching regardless of when it was last used. When **false** the template is never included in auto-matching. |
autoMatchSpecifiedByUser | string | Optional | When **true,** the template has been explicitly included in or excluded from auto-matching. The default is false. This is a read-only property. |
autoNavigation | string | Optional | When **true,** autonavigation is set for the recipient. |
brandId | string | Optional | The ID of the brand. |
brandLock | string | Optional | When **true,** the `brandId` for the envelope is locked and senders cannot change the brand used for the envelope. |
burnDefaultTabData | string | Optional | |
certificateUri | string | Optional | The URI for retrieving certificate information. |
completedDateTime | string | Optional | Specifies the date and time this item was completed. |
copyRecipientData | string | Optional | |
created | string | Optional | The UTC DateTime when the workspace user authorization was created. |
createdDateTime | string | Optional | The UTC DateTime when the item was created. |
customFields | Model | Optional | Expand Gets a list of custom fields — response body An optional array of strings that enables the sender to provide custom data about the recipient. This information is returned in the envelope status but otherwise not used by Docusign. Each `customField` string can be a maximum of 100 characters. |
customFieldsUri | string | Optional | The URI for retrieving custom fields. |
declinedDateTime | string | Optional | The date and time the recipient declined the document. This property is read-only. |
deletedDateTime | string | Optional | Reserved for Docusign. |
deliveredDateTime | string | Optional | The date and time that the envelope was delivered to the recipient. This property is read-only. |
description | string | Optional | A sender-defined description of the line item. |
disableResponsiveDocument | string | Optional | When **true,** responsive documents are disabled for the envelope. |
documentBase64 | string | Optional | The document's bytes. This field can be used to include a base64 version of the document bytes within an envelope definition instead of sending the document using a multi-part HTTP request. The maximum document size is smaller if this field is used due to the overhead of the base64 encoding. |
documents | array | Optional | A complex element that contains details about the documents associated with the envelope. |
documents[] | Model | Each item | Expand Gets a specific template associated with a specified account — response body — documents item |
documentsCombinedUri | string | Optional | The URI for retrieving all of the documents associated with the envelope as a single PDF file. |
documentsUri | string | Optional | The URI for retrieving all of the documents associated with the envelope as separate files. |
emailBlurb | string | Optional | This is the same as the email body. If the sender enters an email blurb, it is included in the email body for all envelope recipients. |
emailSettings | Model | Optional | Expand Adds email setting overrides to an envelope — response body A complex type that contains email settings. |
emailSubject | string | Optional | The subject line of the email message that is sent to all recipients. For information about adding merge field information to the email subject, see [Template Email Subject Merge Fields](/docs/esign-rest-api/reference/templates/templates/create/#template-email-subject-merge-fields). **Note:** The subject line is limited to 100 characters, including any merged fields.It is not truncated. It is an error if the text is longer than 100 characters. |
enableWetSign | string | Optional | When **true,** the signer is allowed to print the document and sign it on paper. |
enforceSignerVisibility | string | Optional | When **true,** the option selected in the **Document Visibility** section in your account [Sending Settings][sendingsettings] will be enforced for the envelope. See [Fields and Properties][fieldsproperties] for details about document visibility options. Setting `enforceSignerVisibility` to **true** also enables you to omit documents from the specified recipients' envelopes by using the [`excludedDocuments`](/docs/esign-rest-api/reference/envelopes/envelopes/create/#schema__envelopedefinition_recipients_signers_excludeddocuments) array. Recipients that have an administrative role (Agent, Editor, or Intermediaries) or informational role (Certified Deliveries or Carbon Copies) can always see all of the documents in an envelope, unless they are specifically excluded by using the `excludedDocuments` setting when an envelope is sent. Documents that do not have tabs are always visible to all recipients, unless they are excluded by using the `excludedDocuments` setting. **Note:** To use this functionality, [document visibility][docviz] must be enabled for the account. The document visibility feature is available in all developer accounts, but only in certain production account plans. Contact [Docusign Support][support] or your account manager to find out whether document visibility is available for your production account plan. [docviz]: /docs/esign-rest-api/reference/envelopes/envelopedocumentvisibility/ [sendingsettings]: https://admindemo.docusign.com/authenticate?goTo=sending [fieldsproperties]: https://support.docusign.com/s/document-item?rsc_301&bundleId=pik1583277475390&topicId=xgg1583277350154.html [support]: https://support.docusign.com/en/contactSupport# |
envelopeAttachments | array | Optional | An array of attachment objects that provide information about the attachments that are associated with the envelope. |
envelopeAttachments[] | Model | Each item | Expand Updates an envelope attachment in a draft or in-process envelope — request body — body |
envelopeCustomMetadata | Model | Optional | Expand Gets the status of a single envelope — response body — envelope Custom Metadata |
envelopeDocuments | array | Optional | An array containing information about the documents that are included in the envelope. |
envelopeDocuments[] | Model | Each item | Expand Updates a template document — response body |
envelopeId | string | Optional | The envelope ID of an envelope that you want to use as the basis for the template. The state of the envelope can be `draft`, `sent`, or `completed`. |
envelopeIdStamping | string | Optional | When **true,** [Envelope ID Stamping](https://support.docusign.com/s/document-item?bundleId=gbo1643332197980&topicId=tfm1578456367923.html) is enabled. After a document or attachment is stamped with an Envelope ID, the ID is seen by all recipients and becomes a permanent part of the document and cannot be removed. |
envelopeLocation | string | Optional | Reserved for Docusign. |
envelopeMetadata | Model | Optional | Expand Gets the status of a single envelope — response body — envelope Metadata Provides information about the features and services that are enabled for the envelope, including the Correct feature, the Advanced Correct feature, and Docusign eNotary service. |
envelopeUri | string | Optional | The URI for retrieving the envelope or envelopes. |
expireAfter | string | Optional | Not used. Use the [`expirations`](/docs/esign-rest-api/reference/envelopes/envelopes/create/#definition__envelopedefinition_notification_expirations) property in the [`notification`](/docs/esign-rest-api/reference/envelopes/envelopes/create/#definition__envelopedefinition_notification) object instead. |
expireDateTime | string | Optional | Not used. Use the [`expirations`](/docs/esign-rest-api/reference/envelopes/envelopes/create/#definition__envelopedefinition_notification_expirations) property in the [`notification`](/docs/esign-rest-api/reference/envelopes/envelopes/create/#definition__envelopedefinition_notification) object instead. |
expireEnabled | string | Optional | Not used. Use the [`expirations`](/docs/esign-rest-api/reference/envelopes/envelopes/create/#definition__envelopedefinition_notification_expirations) property in the [`notification`](/docs/esign-rest-api/reference/envelopes/envelopes/create/#definition__envelopedefinition_notification) object instead. |
externalEnvelopeId | string | Optional | May contain an external identifier for the envelope. |
favoritedByMe | string | Optional | |
folderId | string | Optional | The ID of the folder. |
folderIds | array | Optional | |
folderIds[] | string | Each item | |
folderName | string | Optional | |
folders | array | Optional | A list of folder objects. |
folders[] | Model | Each item | Expand Gets the list of templates — response body — folders item |
hasComments | string | Optional | When **true,** indicates that users have added comments to the envelope. |
hasFormDataChanged | string | Optional | When **true,** indicates that the data collected through form fields on a document has changed. |
hasWavFile | string | Optional | When **true,** indicates that a .wav file used for voice authentication is included in the envelope. |
holder | string | Optional | Reserved for Docusign. |
initialSentDateTime | string | Optional | The date and time the envelope was initially sent. |
is21CFRPart11 | string | Optional | When **true,** indicates compliance with United States Food and Drug Administration (FDA) regulations on electronic records and electronic signatures (ERES). |
isAceGenTemplate | string | Optional | |
isDocGenTemplate | string | Optional | |
isDynamicEnvelope | string | Optional | When **true,** indicates that the envelope is a dynamic envelope. |
isSignatureProviderEnvelope | string | Optional | When **true,** indicates that the envelope is a signature-provided envelope. |
isTicketRelatedEnvelope | string | Optional | |
lastModified | string | Optional | The UTC date and time that the comment was last updated. **Note:** This can only be done by the creator. |
lastModifiedBy | Model | Optional | Expand Gets a specific template associated with a specified account — response body — owner |
lastModifiedDateTime | string | Optional | The date and time that the item was last modified. |
lastUsed | string | Optional | |
location | string | Optional | Reserved for Docusign. |
lockInformation | Model | Optional | Expand Locks an envelope — response body Provides lock information about an envelope that a user has locked. |
messageLock | string | Optional | When **true,** prevents senders from changing the contents of `emailBlurb` and `emailSubject` properties for the envelope. Additionally, this prevents users from making changes to the contents of `emailBlurb` and `emailSubject` properties when correcting envelopes. However, if the `messageLock` node is set to **true** and the `emailSubject` property is empty, senders and correctors are able to add a subject to the envelope. |
name | string | Optional | |
newPassword | string | Optional | The user's new password. |
notification | Model | Optional | Expand Gets envelope notification information — response body |
notificationUri | string | Optional | The URI for retrieving notifications. |
owner | Model | Optional | Expand Gets a specific template associated with a specified account — response body — owner Information about the user who owns the template. |
pageCount | string | Optional | An integer value specifying the number of document pages in the template. |
password | string | Optional | The user's password. This property is used only when adding a new user via a [Users: create](/docs/esign-rest-api/reference/users/users/create/) request. The value must conform to the password rules defined in the account [Security Settings](https://apps-d.docusign.com/admin/authenticate?goTo=securityInfo). This property is not returned by `GET` requests and cannot be updated via `PUT` requests. |
passwordProtected | string | Optional | |
powerForm | Model | Optional | Expand Creates a new Power Form — response body Information about any PowerForms that are included in the envelope. |
powerForms | array | Optional | An array of PowerForm objects. |
powerForms[] | Model | Each item | Expand Creates a new Power Form — response body |
purgeCompletedDate | string | Optional | The date that a purge was completed. |
purgeRequestDate | string | Optional | The date that a purge was requested. |
purgeState | string | Optional | Shows the current purge state for the envelope. Valid values: - `unpurged`: There has been no successful request to purge documents. - `documents_queued`: The envelope documents have been added to the purge queue, but have not been purged. - `documents_dequeued`: The envelope documents have been taken out of the purge queue. - `documents_purged`: The envelope documents have been successfully purged. - `documents_and_metadata_queued`: The envelope documents and metadata have been added to the purge queue, but have not yet been purged. - `documents_and_metadata_purged`: The envelope documents and metadata have been successfully purged. - `documents_and_metadata_and_redact_queued`: The envelope documents and metadata have been added to the purge queue, but have not yet been purged, nor has personal information been redacted. - `documents_and_metadata_and_redact_purged`: The envelope documents and metadata have been successfully purged, and personal information has been redacted. **Related topics** - [Purging documents (eSingature Concepts)](/docs/esign-rest-api/esign101/concepts/documents/purging/) - [Purging documents in an envelope (blog post)](https://www.docusign.com/blog/developers/purging-documents-envelope) |
recipients | Model | Optional | Expand Deletes recipients from an envelope — response body An array of recipient objects that provides details about the recipients of the envelope. |
recipientsLock | string | Optional | When **true,** prevents senders from changing, correcting, or deleting the recipient information for the envelope. |
recipientsUri | string | Optional | Contains a URI for an endpoint that you can use to retrieve the recipients. |
sender | Model | Optional | Expand Gets a specific template associated with a specified account — response body — owner Information about the sender of the envelope. |
sentDateTime | string | Optional | The UTC DateTime when the envelope was sent. This property is read-only. |
shared | string | Optional | When **true,** indicates the template is shared with the **Everyone** group, which includes all users on the account. When **false,** the template is shared only with the groups you specify. |
signerCanSignOnMobile | string | Optional | When **true,** recipients can sign on a mobile device. **Note:** Only Admin users can change this setting. |
signingLocation | string | Optional | Specifies the physical location where the signing takes place. It can have two enumeration values; `inPerson` and `online`. The default value is `online`. |
status | string | Optional | Indicates the envelope status. Valid values are: * `completed`: The recipients have finished working with the envelope: the documents are signed and all required tabs are filled in. * `created`: The envelope is created as a draft. It can be modified and sent later. * `declined`: The envelope has been declined by the recipients. * `delivered`: The envelope has been delivered to the recipients. * `sent`: The envelope will be sent to the recipients after the envelope is created. * `signed`: The envelope has been signed by the recipients. * `voided`: The envelope is no longer valid and recipients cannot access or sign the envelope. |
statusChangedDateTime | string | Optional | The data and time that the status changed. |
templateId | string | Optional | The unique identifier of the template. If this is not provided, Docusign will generate a value. |
templatesUri | string | Optional | The URI for retrieving the templates. |
transactionId | string | Optional | Used to identify an envelope. The ID is a sender-generated value and is valid in the Docusign system for 7 days. It is recommended that a transaction ID is used for offline signing to ensure that an envelope is not sent multiple times. The `transactionId` property can be used determine an envelope's status (i.e. was it created or not) in cases where the internet c onnection was lost before the envelope status was returned. |
uSigState | string | Optional | |
uri | string | Optional | A URI containing the user ID. |
useDisclosure | string | Optional | When **true,** the disclosure is shown to recipients in accordance with the account's Electronic Record and Signature Disclosure frequency setting. When **false,** the Electronic Record and Signature Disclosure is not shown to any envelope recipients. If the `useDisclosure` property is not set, then the account's normal disclosure setting is used and the value of the `useDisclosure` property is not returned in responses when getting envelope information. |
voidedDateTime | string | Optional | The date and time the envelope or template was voided. |
voidedReason | string | Optional | The reason the envelope or template was voided. **Note:** The string is truncated to the first 200 characters. |
workflow | Model | Optional | Expand Returns the workflow definition for a template — response body |
Referenced models: Gets a list of custom fields — response body, Locks an envelope — response body, Deletes recipients from an envelope — response body, Updates an envelope attachment in a draft or in-process envelope — request body — body, Gets a specific template associated with a specified account — response body — documents item, Adds email setting overrides to an envelope — response body, Gets the status of a single envelope — response body — envelope Custom Metadata, Updates a template document — response body, Gets the status of a single envelope — response body — envelope Metadata, Gets the list of templates — response body — folders item, Gets envelope notification information — response body, Creates a new Power Form — response body, Gets a specific template associated with a specified account — response body — owner, Returns the workflow definition for a template — response body
Gets a specific template associated with a specified account — response body — documents item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | A document object. |
applyAnchorTabs | string | Optional | Reserved for Docusign. |
assignTabsToRecipientId | string | Optional | |
authoritativeCopy | boolean | Optional | When **true,** this document is considered an authoritative copy. If this property is not set, it gets its value from the envelope's `authoritativeCopyDefault` property if it's set, or the envelope's `authoritativeCopy` property. When **false,** this document is not an authoritative copy regardless of the envelope's `authoritativeCopyDefault` or `authoritativeCopy` property. |
display | string | Optional | This string sets the display and behavior properties of the document during signing. Valid values: * `modal`<br> 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. * `inline`<br> 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. |
docGenDocumentStatus | string | Optional | |
docGenFormFields | array | Optional | |
docGenFormFields[] | Model | Each item | Expand Updates a template document — response body — doc Gen Form Fields item |
documentBase64 | string | Optional | The document's bytes. This field can be used to include a base64 version of the document bytes within an envelope definition instead of sending the document using a multi-part HTTP request. The maximum document size is smaller if this field is used due to the overhead of the base64 encoding. |
documentFields | array | Optional | The array of name/value custom data strings to be added to a document. Custom document field information is returned in the status, but otherwise is not used by Docusign. The array contains the elements: * `name`: A string that can be a maximum of 50 characters. * `value`: A string that can be a maximum of 200 characters. If you are using XML, the name/value pair is contained in a `nameValue` element. |
documentFields[] | Model | Each item | Expand Updates an existing brand — response body — colors item |
documentId | string | Optional | Specifies the document ID of this document. This value is used by tabs to determine which document they appear in. |
documentTemplateId | string | Optional | |
encryptedWithKeyManager | string | Optional | When **true,** the document has been encrypted by the sender for use with the Docusign Key Manager Security Appliance. |
fileExtension | string | Optional | The file extension type of the document. Non-PDF documents are converted to PDF. If the document is not a PDF, `fileExtension` is required. If you try to upload a non-PDF document without a `fileExtension`, you will receive an "unable to load document" error message. |
fileFormatHint | string | Optional | |
htmlDefinition | Model | Optional | Expand Gets a specific template associated with a specified account — response body — documents item html Definition Defines how to generate the responsive-formatted HTML for the document. See [Responsive signing](/docs/esign-rest-api/esign101/concepts/responsive/) in the [eSignature concepts guide](/docs/esign-rest-api/esign101/concepts/). |
includeInDownload | string | Optional | When **true,** the document is included in the combined document download (`documentsCombinedUri`). This is only applied to [supplemental documents](/docs/esign-rest-api/esign101/concepts/documents/supplemental/). The default value is **true.** |
isDocGenDocument | string | Optional | |
matchBoxes | array | Optional | Matchboxes define areas in a document for document matching when you are creating envelopes. They are only used when you upload and edit a template. |
matchBoxes[] | Model | Each item | Expand Gets a specific template associated with a specified account — response body — documents item match Boxes item |
name | string | Optional | The name of the document. |
order | string | Optional | The order in which to sort the results. Valid values are: * `asc`: Ascending order. * `desc`: Descending order. |
pages | string | Optional | The number of pages in the document. This property is read-only. |
password | string | Optional | The user's password. This property is used only when adding a new user via a [Users: create](/docs/esign-rest-api/reference/users/users/create/) request. The value must conform to the password rules defined in the account [Security Settings](https://apps-d.docusign.com/admin/authenticate?goTo=securityInfo). This property is not returned by `GET` requests and cannot be updated via `PUT` requests. |
pdfFormFieldOption | string | Optional | |
remoteUrl | string | Optional | The file ID from the cloud storage service where the document is located. This information is returned using [CloudStorage: listFolders](/docs/esign-rest-api/reference/cloudstorage/cloudstorage/listfolders/) or [CloudStorage: list](/docs/esign-rest-api/reference/cloudstorage/cloudstorage/list/). |
signerMustAcknowledge | string | Optional | Sets how the signer interacts with the supplemental document. Valid values: * `no_interaction`<br> No recipient action is required. * `view`<br> The recipient is required to view the document. * `accept`<br> The recipient is required to accept the document by selecting accept during signing, but is not required to view the document. * `view_accept`<br> The recipient is required to view and accept the document. |
signerMustAcknowledgeUseAccountDefault | boolean | Optional | When **true,** the account default setting for the required recipient option is used. If this property is set, `signerMustAcknowledge` cannot be set (and vice versa). |
tabs | Model | Optional | Expand Adds tabs for a recipient — esignature esignature Recipients Post Recipient Tabs — response body A list of tabs, which are represented graphically as symbols on documents at the time of signing. Tabs show recipients where to sign, initial, or enter data. They may also display data to the recipients. |
templateLocked | string | Optional | When **true,** the sender cannot change any attributes of the recipient. Used only when working with template recipients. |
templateRequired | string | Optional | When **true,** the sender may not remove the recipient. Used only when working with template recipients. |
transformPdfFields | string | Optional | When **true,** PDF form field data is transformed into document tab values when the PDF form field name matches the Docusign custom tab tabLabel. The resulting PDF form data is also returned in the PDF meta data when requesting the document PDF. |
uri | string | Optional | A URI containing the user ID. |
Referenced models: Adds tabs for a recipient — esignature esignature Recipients Post Recipient Tabs — response body, Updates a template document — response body — doc Gen Form Fields item, Gets a specific template associated with a specified account — response body — documents item html Definition, Gets a specific template associated with a specified account — response body — documents item match Boxes item, Updates an existing brand — response body — colors item
Gets a specific template associated with a specified account — response body — documents item html Definition
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Holds the properties that define how to generate the responsive-formatted HTML for the document. See [Responsive signing](/docs/esign-rest-api/esign101/concepts/responsive/) in the [eSignature concepts guide](/docs/esign-rest-api/esign101/concepts/). |
displayAnchorPrefix | string | Optional | Contains text that all display anchors must start with. Using at least four characters will improve anchor processing performance. |
displayAnchors | array | Optional | An object that defines how to handle a section of the HTML in signing. This property enables an incoming request to make a section of the HTML collapsible and expandable or hidden from view. A start anchor, end anchor, or both are required. If the anchors are not found, the display anchor will be ignored. For a list of the available types, see the [`display` property](/docs/esign-rest-api/reference/envelopes/envelopes/create/#schema__envelopedefinition_documents_htmldefinition_displayanchors_displaysettings_display) of the [`displaySettings` object.](/docs/esign-rest-api/reference/envelopes/envelopes/create/#schema__envelopedefinition_documents_htmldefinition_displayanchors_displaysettings) |
displayAnchors[] | Model | Each item | Expand Gets a specific template associated with a specified account — response body — documents item html Definition display Anchors item |
displayOrder | string | Optional | The position on the page where the display section appears. |
displayPageNumber | string | Optional | The number of the page on which the display section appears. |
documentGuid | string | Optional | The GUID of the document. |
documentId | string | Optional | Specifies the document ID number that the tab is placed on. This must refer to an existing Document's ID attribute. |
headerLabel | string | Optional | Header text or an HTML tag to place above the responsive HTML block. |
maxScreenWidth | string | Optional | If set, the responsive HTML version of the signing document will only display on screens with the specified pixel width or less. If the screen is larger than the value that you specify, the default PDF version of the content displays instead. This setting can also be configured at the account level. |
removeEmptyTags | string | Optional | Holds a comma-separated list of HTML tags to remove if they have no text within their node (including child nodes). |
showMobileOptimizedToggle | string | Optional | When **true** (the default), the **Mobile-Friendly** toggle displays at the top of the screen on the user's mobile device. When **false,** the toggle will not be displayed. the **Mobile-Friendly** toggle lets the user switch between the mobile-friendly and the PDF versions of a document. For example, the recipient can use this toggle to review the document using the PDF view before they finish signing. |
source | string | Optional | Specifies the type of responsive signing that will be used with the document. If the value of this property is valid HTML, and the [smart sections feature][] is enabled, the HTML code is used to display the signing page: ``` source: "<html> ... <body><p>hello world</p></body></html>" ``` If the value of this property is the string `document`, the HTML signing page is generated from the provided document. ``` source: "document" ``` **Related topics** - [How to create a signable HTML document](/docs/esign-rest-api/how-to/creating-signable-html/) - [How to convert a PDF file into a signable HTML document](/docs/esign-rest-api/how-to/converting-pdf/) - [Responsive signing](/docs/esign-rest-api/esign101/concepts/responsive/) [smart sections feature]: https://support.docusign.com/s/document-item?bundleId=gbo1643332197980&topicId=qlx1578456478178.html |
Referenced models: Gets a specific template associated with a specified account — response body — documents item html Definition display Anchors item
Gets a specific template associated with a specified account — response body — documents item html Definition display Anchors item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
caseSensitive | boolean | Optional | When **true,** the start or end anchor strings must match the strings specified by the start and end anchor settings in case as well as in content. |
displaySettings | Model | Optional | Expand Gets a specific template associated with a specified account — response body — documents item html Definition display Anchors item display Settings This object defines how the HTML section inside the `startAnchor` and `endAnchor` displays. |
endAnchor | string | Optional | Specifies the end of the area in the HTML where the display settings will be applied. If you do not specify an end anchor, the end of the document will be used by default. **Note:** A start anchor, an end anchor, or both are required. |
removeEndAnchor | boolean | Optional | When **true,** removes the end anchor string for the Smart Section from the HTML, preventing it from displaying. |
removeStartAnchor | boolean | Optional | When **true,** removes the start anchor string for the Smart Section from the HTML, preventing it from displaying. |
startAnchor | string | Optional | Specifies the beginning of the area in the HTML where the display settings will be applied. If you do not specify a start anchor, the beginning of the document will be used by default. **Note:** A start anchor, an end anchor, or both are required. |
Referenced models: Gets a specific template associated with a specified account — response body — documents item html Definition display Anchors item display Settings
Gets a specific template associated with a specified account — response body — documents item html Definition display Anchors item display Settings
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | This object defines how to display the HTML between the `startAnchor` and `endAnchor`. |
cellStyle | string | Optional | Specifies the valid CSS-formatted styles to use on responsive table cells. Only valid in display sections of `responsive_table` or `responsive_table_single_column` types. |
collapsibleSettings | Model | Optional | Expand Creates a preview of the responsive version of a document — request body — body display Anchors item display Settings collapsible Settings This object defines the appearance and function of a collapsible section or item. |
display | string | Optional | Sets the display and behavior properties. Possible values are: - `inline`: Leaves the HTML where it is in the document. This property lets you add a label or present on a separate page. - `collapsible`: The HTML in this section may be expanded or collapsed. Initially this section is expanded. - `collapsed`: The HTML in this section may be expanded or collapsed. Initially this section is collapsed. - `continue_button`: Creates a stop point in the document to draw the reader's attention before proceeding to the next section. - `responsive_table`: Turns this section into a responsive table. Note that this is only used on HTML tables that fall within the anchor start and end positions. - `responsive_table_single_column`: Turns this section into a responsive single-column table. Note this is only used on HTML tables that fall within the anchor start and end positions. The table will be converted to one single column where each current column will become a row, then stacked. - `print_only`: Do not show this portion of the HTML in the responsive signing view. |
displayLabel | string | Optional | The label to add to this display section in the signing page. |
displayOrder | JSON | Optional | |
displayOrder (anyOf 1) | integer | Alternative | The position on the page where the display section appears. Format: int32 |
displayOrder (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
displayPageNumber | JSON | Optional | |
displayPageNumber (anyOf 1) | integer | Alternative | The number of the page on which the display section appears. Format: int32 |
displayPageNumber (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
hideLabelWhenOpened | boolean | Optional | When **true,** the `displayLabel` is hidden when the display section is expanded and the display section is no longer collapsible. This property is valid only when the value of the `display` property is `collapsed`. |
inlineOuterStyle | string | Optional | Specifies the valid CSS-formatted styles to use on inline display sections. This property is valid only when the value of the `display` property is `inline`. |
labelWhenOpened | string | Optional | The label for the display section when it is expanded from a collapsed state. This label displays only on the first opening and is only valid with the value of the `display` property is `collapsed`. |
preLabel | string | Optional | Enables you to add descriptive text that appears before a collapsed section or continue button. |
scrollToTopWhenOpened | boolean | Optional | When **true** and the section is expanded, the position of the section-close control scrolls to the top of the screen. This property is only valid when the value of the `display` property is `collapsed`. |
tableStyle | string | Optional | Specifies the valid CSS-formatted styles to use on responsive tables. This property is valid only when the value of the `display` property is `responsive_table` or `responsive_table_single_column`. |
Referenced models: Creates a preview of the responsive version of a document — request body — body display Anchors item display Settings collapsible Settings
Gets a specific template associated with a specified account — response body — documents item match Boxes item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
height | string | Optional | The height of the tab in pixels. Must be an integer. |
pageNumber | string | Optional | Specifies the page number on which the tab is located. Must be 1 for supplemental documents. |
width | string | Optional | The width of the tab in pixels. Must be an integer. |
xPosition | string | Optional | This property indicates the horizontal offset of the object on the page. Docusign uses 72 DPI when determining position. Required. Must be an integer. May be zero. |
yPosition | string | Optional | This property indicates the vertical offset of the object on the page. Docusign uses 72 DPI when determining position. Required. Must be an integer. May be zero. |
Gets a specific template associated with a specified account — response body — owner
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
accountId | string | Optional | The account ID associated with the envelope. |
accountName | string | Optional | The name on the account. |
activationAccessCode | string | Optional | Access code provided to the user to activate the account. |
email | string | Optional | The user's email address. |
errorDetails | Model | Optional | Expand Locks a template — response body — error Details This object describes errors that occur. It is only valid for responses and ignored in requests. |
ipAddress | string | Optional | |
loginStatus | string | Optional | When **true,** indicates that the user is logged in. This is a read-only property. |
membershipId | string | Optional | The user's membership ID. |
sendActivationEmail | string | Optional | This field is no longer supported for most accounts. To create an eSignature user without sending an activation email, use the Admin API by following [these steps](/docs/admin-api/how-to/create-active-user/). |
uri | string | Optional | A URI containing the user ID. |
userId | string | Optional | The ID of the user to access. |
userName | string | Optional | The name of the user. |
userStatus | string | Optional | Status of the user's account. One of: - `ActivationRequired` - `ActivationSent` - `Active` - `Closed` - `Disabled` |
userType | string | Optional | The type of user, for example `CompanyUser`. |
Referenced models: Locks a template — response body — error Details