How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Docusign EnvelopeDocuments API

Manage documents within envelopes including adding, retrieving, and deleting documents attached to envelopes.

Docusign EnvelopeDocuments API is one of 134 APIs that Docusign publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

This API exposes 1 JSON Schema definition.

Tagged areas include EnvelopeDocuments. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, a JSON-LD context, a getting-started guide, rate-limit docs, and 1 JSON Schema.

This API exposes 7 operations across 4 paths, and defines 107 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 5 base URLs: https://demo.docusign.net/restapi/v2.1, https://www.docusign.net/restapi/v2.1, https://eu.docusign.net/restapi/v2.1, https://au.docusign.net/restapi/v2.1, https://www.docusign.net/restapi.

7 operations 4 paths 107 schemas 1 DELETE4 GET2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://demo.docusign.net/restapi
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Docusign EnvelopeDocuments API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth2) using the authorizationCode and implicit flows, exposing 3 scopes.

  • OAuth2 — DocuSign uses OAuth 2.0. Supports Authorization Code Grant for user-present applications and JWT Grant for service integrations.

Paths & Operations 7

Across 4 paths, the API surfaces 7 operations — 1 DELETE, 4 GET, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

EnvelopeDocuments 7

Manage documents within envelopes including adding, retrieving, and deleting documents attached to envelopes.

GET
/accounts/{accountId}/envelopes/{envelopeId}/documents
Docusign List Envelope Documents
EnvelopeDocuments_ListDocuments 2 params → 200400401404
GET
/accounts/{accountId}/envelopes/{envelopeId}/documents/{documentId}
Docusign Get an Envelope Document
EnvelopeDocuments_GetDocument 3 params → 200400401404
GET
/v2/accounts/{accountId}/envelopes/{envelopeId}/documents
Docusign Gets a list of envelope documents.
Documents_GetDocuments 3 params → 200400
PUT
/v2/accounts/{accountId}/envelopes/{envelopeId}/documents
Docusign Adds one or more documents to an existing envelope document.
Documents_PutDocuments 4 params body → 200400
DELETE
/v2/accounts/{accountId}/envelopes/{envelopeId}/documents
Docusign Deletes documents from a draft envelope.
Documents_DeleteDocuments 2 params body → 200400
GET
/v2/accounts/{accountId}/envelopes/{envelopeId}/documents/{documentId}
Docusign Gets a document from an envelope.
Documents_GetDocument 10 params → 200400
PUT
/v2/accounts/{accountId}/envelopes/{envelopeId}/documents/{documentId}
Docusign Adds a document to an existing draft envelope.
Documents_PutDocument 4 params → 200400

Schemas 107

The contract defines 107 schemas that model the data the API accepts and returns. The most detailed are witness (65 properties), signer (62 properties), envelopeDefinition (61 properties), inPersonSigner (59 properties). Each schema is shown below with its type and property counts.

ErrorDetails
object
Contains error information returned by the API.
2 properties
EnvelopeDocument
object
Metadata about a document within an envelope.
9 properties
EnvelopeDocumentsResult
object
Contains the list of documents in an envelope.
2 properties
addressInformationInput
object
Contains address input information.
3 properties
recipientPhoneAuthentication
object
A complex type that Contains the elements: recipMayProvideNumber - Boolean. When set to true, the recipient can use whatever phone number they choose. senderPr…
4 properties
recipientIdentityPhoneNumber
object
3 properties
fullName
object
A tab that displays the recipient's full name.
34 properties
textCustomField
object
7 properties
number
object
A tab that allows the recipient to enter numbers and decimal (.) points.
49 properties
eventResult
object
4 properties
listItem
object
One of the selectable items in the listItems property of a [list](https://developers.docusign.com/esign-rest-api/reference/Envelopes/EnvelopeRecipientTabs/crea…
3 properties
editor
object
45 properties
userInfo
object
10 properties
eventNotification
object
Register a Connect webhook for a specific envelope
16 properties
compositeTemplate
object
5 properties
documentHtmlDisplayAnchor
object
6 properties
authenticationStatus
object
Contains information about the authentication status.
19 properties
paymentLineItem
object
A line item describes details about an individual line item in a payment request.
4 properties
firstName
object
A tab that displays the recipient's first name. This tab takes the recipient's name as entered in the recipient information, splits it into sections based on s…
34 properties
AccountCustomFields
object
Custom Fields
2 properties
recipientProofFile
object
1 property
dobInformationInput
object
Complex type containing: dateOfBirth displayLevelCode receiveInResponse
3 properties
formulaTab
object
The value of a formula tab is calculated from the values of other number or date tabs in the document. When the recipient completes the underlying fields, the…
52 properties
envelopeEvent
object
For which envelope events should your webhook be called?
2 properties
recipientIdentityVerification
object
2 properties
paymentDetails
object
When a formula tab has a paymentDetails property, the formula tab is a payment item. See [Requesting Payments Along with Signatures][paymentguide] in the DocuS…
15 properties
ssn9InformationInput
object
2 properties
agent
object
Contains information about agent recipients.
46 properties
inPersonSigner
object
An in-person recipient is a DocuSign user, acting as a Signing Host, who is in the same physical location as the signer. To learn about fields used for eNotary…
59 properties
recipientEmailNotification
object
3 properties
initialHere
object
A tab that allows the recipient to initial the document. May be optional.
29 properties
signatureType
object
2 properties
templateRole
object
13 properties
checkbox
object
A tab that allows the recipient to select a yes/no (on/off) option.
32 properties
approve
object
A tab that allows the recipient to approve documents without placing a signature or initials on the document.
35 properties
signHere
object
A tab that allows the recipient to sign a document. May be optional.
31 properties
idCheckInformationInput
object
A complex element that contains input information related to a recipient ID check. It can include the following information. addressInformationInput: Used to s…
4 properties
radio
object
One of the selectable radio buttons in the radios property of a [radioGroup](https://developers.docusign.com/esign-rest-api/reference/Envelopes/EnvelopeRecipie…
18 properties
expirations
object
A complex element that specifies the expiration settings for the envelope.
3 properties
email
object
A tab that allows the recipient to enter an email address. This is a one-line field that checks that a valid email address is entered. It uses the same paramet…
47 properties
errorDetails
object
This object describes errors that occur. It is only valid for responses, and ignored in requests.
2 properties
envelopeId
object
A tab that displays the envelope ID. Recipients cannot enter or change the information in this tab.
33 properties
mergeField
object
Contains information for transfering values between Salesforce data fields and DocuSign Tabs.
5 properties
lastName
object
A tab that displays the recipient's last name. This tab takes the recipient's name as entered in the recipient information, splits it into sections based on sp…
34 properties
envelope
object
52 properties
ssn4InformationInput
object
3 properties
smartSectionCollapsibleDisplaySettings
object
10 properties
witness
object
65 properties
emailSettings
object
3 properties
EnvelopeRecipientTabs
object
All of the tabs associated with a recipient. Each property is a list of a type of tab.
27 properties
document
object
A document object.
22 properties
dateSigned
object
A tab that displays the date that the recipient signed the document.
34 properties
company
object
A tab that displays the recipient's company name.
41 properties
recipientSignatureProviderOptions
object
Option settings for the signature provider. Different providers require or use different options. [The current provider list and the options they require.](htt…
4 properties
recipientAttachment
object
6 properties
recipientIdentityInputOption
object
3 properties
radioGroup
object
This group tab is used to place radio buttons on a document. The radios property contains a list of [radio](https://developers.docusign.com/esign-rest-api/refe…
12 properties
carbonCopy
object
49 properties
signerAttachment
object
A tab that allows the recipient to attach supporting documents to an envelope.
29 properties
socialAuthentication
object
1 property
emailAddress
object
A tab that displays the recipient's email as entered in the recipient information.
34 properties
zip
object
A tab that allows the recipient to enter a ZIP code. The ZIP code can be five digits or nine digits in the ZIP+4 format. The zip code can be typed with or with…
48 properties
view
object
This tab is used with the Approve tab to handle supplemental documents.
37 properties
smartSection
object
33 properties
attachment
object
Contains information about an attachment.
7 properties
envelopeDocumentsResult
object
2 properties
money
object
Describes information about the total of a payment.
3 properties
certifiedDelivery
object
49 properties
documentVisibility
object
5 properties
notarize
object
A tab that alerts notary recipients that they must take action on the page. Only one notarize tab can appear on a page.
27 properties
title
object
A tab that displays the recipient's title.
41 properties
bccEmailAddress
object
Contains information about the BCC email address.
2 properties
note
object
A tab that displays additional information, in the form of a note, for the recipient.
37 properties
envelopeDefinition
object
61 properties
EnvelopeLocks
object
Envelope locks
8 properties
matchBox
object
5 properties
samlAssertionAttribute
object
4 properties
text
object
A tab that allows the recipient to enter any type of text.
50 properties
intermediary
object
46 properties
recipientSignatureInformation
object
Allows the sender to pre-specify the signature name, signature initials and signature font used in the signature stamp for the recipient. Used only with recipi…
3 properties
ssn
object
A one-line field that allows the recipient to enter a Social Security Number. The SSN can be typed with or without dashes. It uses the same parameters as a Tex…
47 properties
recipientSignatureProvider
object
An Electronic or Standards Based Signature (digital signature) provider for the signer to use. [More information](https://developers.docusign.com/esign-rest-ap…
4 properties
signer
object
A complex type containing information about a signer recipient. A signer is a recipient who must take action on a document, such as sign, initial, date, or add…
62 properties
envelopeDocument
object
16 properties
date
object
A tab that allows the recipient to enter a date. Date tabs are one-line fields that allow date information to be entered in any format. The tooltip for this ta…
47 properties
recipientSAMLAuthentication
object
Contains the name/value pair information for the SAML assertion attributes: name - The name of the SAML assertion attribute. value - The value associated with…
1 property
smartSectionDisplaySettings
object
12 properties
reminders
object
A complex element that specifies reminder settings for the envelope
3 properties
inlineTemplate
object
5 properties
addressInformation
object
Contains address information.
9 properties
listCustomField
object
8 properties
list
object
This tab offers a list of options to choose from. The listItems property contains a list of [listItem](https://developers.docusign.com/esign-rest-api/reference…
41 properties
decline
object
A tab that allows the recipient the option of declining an envelope. If the recipient clicks the tab during the signing process, the envelope is voided.
36 properties
serverTemplate
object
2 properties
paymentSignerValues
object
1 property
nameValue
object
4 properties
notification
object
A complex element that specifies the notification options for the envelope. It consists of: useAccountDefaults - When set to true, the account default notifica…
3 properties
sealSign
object
Specifies one or more electronic seals to apply on documents. json "recipients": { "seals": [ { "recipientId": "1", "routingOrder" : 1, "recipientSignatureProv…
39 properties
documentHtmlDisplaySettings
object
12 properties
recipientEvent
object
2 properties
notaryHost
object
This object is used only when inPersonSigningType in the inPersonSigner object is notary. It describes information about the notary host. The following informa…
40 properties
EnvelopeRecipients
object
Envelope recipients
12 properties
recipientSMSAuthentication
object
Contains the element senderProvidedNumbers which is an Array of phone numbers the recipient can use for SMS text authentication.
1 property
smartSectionAnchorPosition
object
3 properties
documentHtmlCollapsibleDisplaySettings
object
10 properties
propertyMetadata
object
2 properties
documentHtmlDefinition
object
11 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

docusign-envelopedocuments-api-openapi.yml Raw ↑

Other APIs Docusign publishes across the network.

Docusign Web Forms API
Docusign Notary API
Docusign Navigator API
Docusign Workspaces API
Docusign CLM API
Docusign Connected Fields API
Docusign AccountBrands API
Docusign AccountConsumerDisclosures API
Docusign AccountCustomFields API
Docusign AccountPasswordRules API
Docusign AccountPermissionProfiles API
Docusign Accounts API
Where this information came from

This is an independent, third-party profile of Docusign EnvelopeDocuments API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.