Skip to navigation

Get status of single envelope

View as Markdown

Retrieves the overall status for the specified envelope. To get the status of a list of envelopes, use Envelope: listStatusChanges

Authentication

Authorizationstring

OAuth 2.0 access token (JWT or auth-code grant). Sent as Authorization: Bearer <token>.

Path parameters

accountIdstringRequired

The external account number (int) or account id GUID.

envelopeIdstringRequired

The envelope’s GUID. Eg 93be49ab-afa0-4adf-933c-f752070d71ec

Query parameters

advanced_updatestringOptional
When true, envelope information can be added or modified.
includestringOptional
Reserved for DocuSign.

Response

Successful response.
allowMarkupstringOptional

When set to true, Document Markup is enabled for envelope. Account must have Document Markup enabled to use this

allowReassignstringOptional

When set to true, the recipient can redirect an envelope to a more appropriate recipient.

allowViewHistorystringOptional
asynchronousstringOptional

When set to 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 using the transactionId or by checking the Connect notification.

attachmentsUristringOptional
authoritativeCopystringOptional

Specifies whether all documents in this envelope are authoritative copies. A document can set its own authoritativeCopy property to override this value. For example you can set the authoritativeCopy on an envelope level to true but can turn it off for a specific document.

authoritativeCopyDefaultstringOptional

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.

autoNavigationstringOptional

When set to true, autonavigation is set for the recipient.

brandIdstringOptional
The unique identifier of a brand.
brandLockstringOptional
certificateUristringOptional
Retrieves a URI for an endpoint allowing you to easily retrieve certificate information.
completedDateTimestringOptional
Specifies the date and time this item was completed.
copyRecipientDatastringOptional
createdDateTimestringOptional
Indicates the date and time the item was created.
customFieldsobjectOptional
Custom Fields
customFieldsUristringOptional
Contains a URI for an endpoint to retrieve the custom fields.
declinedDateTimestringOptional
The date and time the recipient declined the document. Read only.
deletedDateTimestringOptional
Specifies the data and time the item was deleted.
deliveredDateTimestringOptional

Reserved: For DocuSign use only.

disableResponsiveDocumentstringOptional
documentsCombinedUristringOptional
documentsUristringOptional
Contains a URI for an endpoint that you can use to retrieve the documents.
emailBlurbstringOptional
emailSettingsobjectOptional
emailSubjectstringOptional

Specifies the subject of the email that is sent to all recipients.

See [ML:Template Email Subject Merge Fields] for information about adding merge field information to the email subject.

enableWetSignstringOptional

When set to true, the signer is allowed to print the document and sign it on paper.

enforceSignerVisibilitystringOptional

When set to true, documents with tabs can only be viewed by signers that have a tab on that document. Recipients that have an administrative role (Agent, Editor, or Intermediaries) or informational role (Certified Deliveries or Carbon Copies) can always see all the documents in an envelope, unless they are specifically excluded using this setting when an envelope is sent. Documents that do not have tabs are always visible to all recipients, unless they are specifically excluded using this setting when an envelope is sent.

Note: Your account must have Document Visibility enabled to use this.
envelopeIdstringOptional

The envelope’s GUID. Eg 93be49ab-afa0-4adf-933c-f752070d71ec

envelopeIdStampingstringOptional

When set to true, Envelope ID Stamping is enabled.

envelopeUristringOptional
Contains a URI for an endpoint that you can use to retrieve the envelope or envelopes.
initialSentDateTimestringOptional
is21CFRPart11stringOptional

When set to true, indicates that this module is enabled on the account.

isSignatureProviderEnvelopestringOptional
lastModifiedDateTimestringOptional
The date and time the item was last modified.
lockInformationobjectOptional
Envelope locks
messageLockstringOptional

When set to 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.

notificationobjectOptional

A complex element that specifies the notification options for the envelope. It consists of:

  • useAccountDefaults - When set to true, the account default notification settings are used for the envelope.

  • reminders - A complex element that specifies reminder settings for the envelope. It consists of:

    • reminderEnabled - When set to true, a reminder message is sent to the recipient.
    • reminderDelay - An interger that sets the number of days after the recipient receives the envelope that reminder emails are sent to the recipient.
    • reminderFrequency - An interger that sets the interval, in days, between reminder emails.
  • expirations - A complex element that specifies the expiration settings for the envelope. It consists of:

    • expireEnabled - When set to true, the envelope expires (is no longer available for signing) in the set number of days. If false, the account default setting is used. If the account does not have an expiration setting, the DocuSign default value of 120 days is used.
    • expireAfter - An integer that sets the number of days the envelope is active.
    • expireWarn - An integer that sets the number of days before envelope expiration that an expiration warning email is sent to the recipient. If set to 0 (zero), no warning email is sent.
notificationUristringOptional
Contains a URI for an endpoint that you can use to retrieve the notifications.
purgeStatestringOptional

Shows the current purge state for the envelope. The possible values are:

  • 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_and_metadata_queued: The envelope documents and metadata have been added to the purge queue, but have not yet been purged.
  • documents_purged: The envelope documents have been successfully purged.
  • documents_and_metadata_purged: The envelope documents and metadata have been successfully purged.
recipientsobjectOptional
Envelope recipients
recipientsLockstringOptional

When set to true, prevents senders from changing, correcting, or deleting the recipient information for the envelope.

recipientsUristringOptional
Contains a URI for an endpoint that you can use to retrieve the recipients.
sentDateTimestringOptional
The UTC DateTime when the envelope was sent. Read only.
signerCanSignOnMobilestringOptional
signingLocationstringOptional

Specifies the physical location where the signing takes place. It can have two enumeration values; InPerson and Online. The default value is Online.

statusstringOptional
Item status.
statusChangedDateTimestringOptional
The data and time the status changed.
templatesUristringOptional
Contains a URI for an endpoint which you can use to retrieve the templates.
transactionIdstringOptional
Specifies the Transaction ID from the AppStore.
useDisclosurestringOptional

When set to true, the disclosure is shown to recipients in accordance with the account’s Electronic Record and Signature Disclosure frequency setting. When set to 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.

voidedDateTimestringOptional
The date and time the envelope or template was voided.
voidedReasonstringOptional
The reason the envelope or template was voided.

Errors

400
Bad Request Error