openapi: 3.0.1
info:
title: DocuSign Admin AccountBrands EnvelopeConsumerDisclosures API
description: An API for an organization administrator to manage organizations, accounts and users
termsOfService: https://www.docusign.com/company/terms-and-conditions/developers
contact:
name: DocuSign Developer Center
url: https://developers.docusign.com
email: devcenter@docusign.com
version: v2.1
servers:
- url: https://api.docusign.net/Management
tags:
- name: EnvelopeConsumerDisclosures
description: The EnvelopeConsumerDisclosures resource provides a method that allows you to retrieve the consumer disclosure for an envelope.
paths:
/v2/accounts/{accountId}/envelopes/{envelopeId}/recipients/{recipientId}/consumer_disclosure:
get:
tags:
- EnvelopeConsumerDisclosures
summary: Docusign Gets the Electronic Record and Signature Disclosure associated with the account.
description: Retrieves the Electronic Record and Signature Disclosure, with html formatting, associated with the account. You can use an optional query string to set the language for the disclosure.
operationId: ConsumerDisclosure_GetConsumerDisclosureEnvelopeIdRecipientId
parameters:
- name: accountId
in: path
description: The external account number (int) or account id GUID.
required: true
schema:
type: string
- name: envelopeId
in: path
description: 'The envelope''s GUID. Eg 93be49ab-afa0-4adf-933c-f752070d71ec '
required: true
schema:
type: string
- name: recipientId
in: path
description: A local reference that senders use to map recipients to other objects, such as specific document tabs. Within an envelope, each `recipientId` must be unique, but there is no uniqueness requirement across envelopes. For example, many envelopes assign the first recipient a `recipientId` of `1`.
required: true
schema:
type: string
- name: langCode
in: query
schema:
type: string
responses:
'200':
description: Successful response.
content:
'*/*':
schema:
$ref: '#/components/schemas/consumerDisclosure'
'400':
description: Error encountered.
content:
'*/*':
schema:
$ref: '#/components/schemas/errorDetails'
deprecated: false
x-ds-methodname: getConsumerDisclosureDefault
x-ds-method: getDefault
x-ds-service: Envelopes
x-ds-in-sdk: true
/v2/accounts/{accountId}/envelopes/{envelopeId}/recipients/{recipientId}/consumer_disclosure/{langCode}:
get:
tags:
- EnvelopeConsumerDisclosures
summary: 'Docusign Reserved: Gets the Electronic Record and Signature Disclosure associated with the account.'
description: 'Reserved: Retrieves the Electronic Record and Signature Disclosure, with HTML formatting, associated with the account.'
operationId: ConsumerDisclosure_GetConsumerDisclosureEnvelopeIdRecipientIdLangCode
parameters:
- name: accountId
in: path
description: The external account number (int) or account id GUID.
required: true
schema:
type: string
- name: envelopeId
in: path
description: 'The envelope''s GUID. Eg 93be49ab-afa0-4adf-933c-f752070d71ec '
required: true
schema:
type: string
- name: langCode
in: path
description: The simple type enumeration the language used in the response. The supported languages, with the language value shown in parenthesis, are:Arabic (ar), Bulgarian (bg), Czech (cs), Chinese Simplified (zh_CN), Chinese Traditional (zh_TW), Croatian (hr), Danish (da), Dutch (nl), English US (en), English UK (en_GB), Estonian (et), Farsi (fa), Finnish (fi), French (fr), French Canada (fr_CA), German (de), Greek (el), Hebrew (he), Hindi (hi), Hungarian (hu), Bahasa Indonesia (id), Italian (it), Japanese (ja), Korean (ko), Latvian (lv), Lithuanian (lt), Bahasa Melayu (ms), Norwegian (no), Polish (pl), Portuguese (pt), Portuguese Brazil (pt_BR), Romanian (ro), Russian (ru), Serbian (sr), Slovak (sk), Slovenian (sl), Spanish (es),Spanish Latin America (es_MX), Swedish (sv), Thai (th), Turkish (tr), Ukrainian (uk) and Vietnamese (vi). Additionally, the value can be set to "browser" to automatically detect the browser language being used by the viewer and display the disclosure in that language.
required: true
schema:
type: string
- name: recipientId
in: path
description: A local reference that senders use to map recipients to other objects, such as specific document tabs. Within an envelope, each `recipientId` must be unique, but there is no uniqueness requirement across envelopes. For example, many envelopes assign the first recipient a `recipientId` of `1`.
required: true
schema:
type: string
- name: langCode
in: query
schema:
type: string
responses:
'200':
description: Successful response.
content:
'*/*':
schema:
$ref: '#/components/schemas/consumerDisclosure'
'400':
description: Error encountered.
content:
'*/*':
schema:
$ref: '#/components/schemas/errorDetails'
deprecated: false
x-ds-methodname: getConsumerDisclosure
x-ds-method: get
x-ds-service: Envelopes
x-ds-in-sdk: true
components:
schemas:
consumerDisclosure:
type: object
properties:
accountEsignId:
type: string
description: A GUID identifying the account associated with the consumer disclosure
allowCDWithdraw:
type: string
description: Indicates whether the customer can withdraw their acceptance of the consumer disclosure.
allowCDWithdrawMetadata:
$ref: '#/components/schemas/settingsMetadata'
changeEmail:
type: string
description: ''
changeEmailOther:
type: string
description: ''
companyName:
type: string
description: The name of the user's Company.
companyPhone:
type: string
description: The phone number of the company associated with the consumer disclosure.
copyCostPerPage:
type: string
description: ''
copyFeeCollectionMethod:
type: string
description: 'Specifies the fee collection method for cases in which the customer requires paper copies of the document.
Maximum Length: 255 characters'
copyRequestEmail:
type: string
description: ''
custom:
type: string
description: ''
enableEsign:
type: string
description: ''
esignAgreement:
type: string
description: The Electronic Record and Signature Disclosure text. The disclosure text includes the html formatting.
esignText:
type: string
description: ''
languageCode:
type: string
description: ''
mustAgreeToEsign:
type: string
description: ''
pdfId:
type: string
description: "**Deprecated**\n\nThe `\x80\x9CpdfId` property in the consumer_disclosure PUT request is deprecated. For security reasons going forward, any value provided in the request packet must be ignored. "
useBrand:
type: string
description: ''
useConsumerDisclosureWithinAccount:
type: string
description: ''
useConsumerDisclosureWithinAccountMetadata:
$ref: '#/components/schemas/settingsMetadata'
withdrawAddressLine1:
type: string
description: 'Contains the first address line of the postal address to which a customer can send a consent withdrawal notification.
Maximum length: 100 characters. '
withdrawAddressLine2:
type: string
description: 'Contains the second address line of the postal address to which a customer can send a consent withdrawal notification.
Maximum length: 100 characters. '
withdrawByEmail:
type: string
description: Indicates whether the customer can withdraw consent by email.
withdrawByMail:
type: string
description: Indicates whether the customer can withdraw consent by postal mail.
withdrawByPhone:
type: string
description: Indicates whether the customer can withdraw consent by phone.
withdrawCity:
type: string
description: 'Contains the city of the postal address to which a customer can send a consent withdrawal notification.
Maximum length: 50 characters. '
withdrawConsequences:
type: string
description: Indicates the consequences of withdrawing consent.
withdrawEmail:
type: string
description: 'Contains the email address to which a customer can send a consent withdrawal notification.
Maximum length: 100 characters. '
withdrawOther:
type: string
description: 'Indicates other information need to withdraw consent.
Maximum length: 255 characters.'
withdrawPhone:
type: string
description: 'Contains the phone number which a customer can call to register consent withdrawal notification.
Maximum length: 20 characters. '
withdrawPostalCode:
type: string
description: 'Contains the postal code of the postal address to which a customer can send a consent withdrawal notification.
Maximum length: 20 characters. '
withdrawState:
type: string
description: Contains the state of the postal address to which a customer can send a consent withdrawal notification.
description: ''
x-ds-definition-name: consumerDisclosure
x-ms-summary: ''
settingsMetadata:
type: object
properties:
is21CFRPart11:
type: string
description: When set to **true**, indicates that this module is enabled on the account.
options:
type: array
description: ''
items:
type: string
rights:
type: string
description: ''
uiHint:
type: string
description: ''
uiOrder:
type: string
description: ''
uiType:
type: string
description: ''
description: ''
x-ds-definition-name: settingsMetadata
x-ms-summary: ''
errorDetails:
type: object
properties:
errorCode:
type: string
description: An error code associated with the error.
message:
type: string
description: A short error message.
description: This object describes errors that occur. It is only valid for responses, and ignored in requests.
x-ds-definition-name: errorDetails
x-ms-summary: This object describes errors that occur. It is only valid for responses, and ignored in requests.
securitySchemes:
accessCode:
type: oauth2
description: OAuth2 Access code Grant
flows:
authorizationCode:
authorizationUrl: https://account.docusign.com/oauth/auth
tokenUrl: https://account.docusign.com/oauth/auth
scopes:
organization_read: ''
permission_read: ''
group_read: ''
user_read: ''
account_read: ''
account_write: ''
user_write: ''
identity_provider_read: ''
domain_read: ''
x-ds-categories:
- name: UserManagement
summary: Methods to manage users in an account.
description: Methods to manage users in an account.
- name: BulkOperations
summary: Methods to import and export users and accounts.
description: Methods to import and export users and accounts.
- name: IdentityProviders
summary: Methods to get a list of identity providers.
description: Methods to get a list of identity providers.
- name: ReservedDomains
summary: Methods to get a list of reserved domains.
description: Methods to get a list of reserved domains.
- name: Organization
summary: Methods for working with organizations.
description: Methods for working with organizations.
x-original-swagger-version: '2.0'