Account Consumer Disclosures

Gets the default Electronic Record and Signature Disclosure for an account

GET
/v2.1/accounts/{accountId}/consumer_disclosure

Retrieves the default, HTML-formatted Electronic Record and Signature Disclosure (ERSD) associated with the account.

This is the default ERSD disclosure that Docusign provides for the convenience of U.S.-based customers only. This default disclosure is only valid for transactions between U.S.-based parties.

To set the language of the disclosure that you want to retrieve, use the optional langCode query parameter.

Authorization

OAuth2
AuthorizationBearer <token>

OAuth 2.0 access token obtained via Authorization Code Grant or JWT Grant.

In: header

Path Parameters

accountId*string

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

Query Parameters

langCode?string

The code for the signer language version of the disclosure that you want to retrieve. The following languages are supported:

  • 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 Canadian (fr_CA)
  • German (de)
  • Greek (el)
  • Hebrew (he)
  • Hindi (hi)
  • Hungarian (hu)
  • Bahasa Indonesian (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)
  • Vietnamese (vi)

Additionally, you can automatically detect the browser language being used by the viewer and display the disclosure in that language by setting the value to browser.

Response Body

application/json

application/json

curl -X GET "https://example.com/v2.1/accounts/string/consumer_disclosure"
{  "accountEsignId": "string",  "allowCDWithdraw": "string",  "changeEmail": "string",  "changeEmailOther": "string",  "companyName": "string",  "companyPhone": "string",  "copyCostPerPage": "string",  "copyFeeCollectionMethod": "string",  "copyRequestEmail": "string",  "custom": "string",  "enableEsign": "string",  "esignAgreement": "string",  "esignText": "string",  "languageCode": "string",  "mustAgreeToEsign": "string",  "pdfId": "string",  "useBrand": "string",  "useConsumerDisclosureWithinAccount": "string",  "withdrawAddressLine1": "string",  "withdrawAddressLine2": "string",  "withdrawByEmail": "string",  "withdrawByMail": "string",  "withdrawByPhone": "string",  "withdrawCity": "string",  "withdrawConsequences": "string",  "withdrawEmail": "string",  "withdrawOther": "string",  "withdrawPhone": "string",  "withdrawPostalCode": "string",  "withdrawState": "string"}

Updates a branding resource file PUT

This method updates a branding resource file. You pass in the new version of the resource file in the `Content-Disposition` header. Example: `Content-Disposition: form-data; name="file"; filename="DocuSign_SigningResource_4328673.xml"` **Note:** Branding for either signing or sending must be enabled for the account (`canSelfBrandSend` , `canSelfBrandSign`, or both of these account settings must be **true**). **Important:** Customizing resource files is an advanced branding configuration option which can significantly impact your account, and should be done only by someone with expertise in XML and HTML. The master resource files are subject to change without notice. If you customize your resource files, after each release, Docusign recommends you review any changes and update your custom files as needed. When you upload a modified resource file, only the elements that differ from the master resource file are saved as your resource file. Similarly, when you download your resource files, only the modified elements are included in the file.

Gets the Electronic Record and Signature Disclosure for an account GET

Retrieves the HTML-formatted Electronic Record and Signature Disclosure (ERSD) associated with the account. To set the language of the disclosure that you want to retrieve, use the optional `langCode` query parameter. **Note:** The text of the default disclosure is always in English, but if you are using a custom disclosure and have created versions of it in different signer languages, you can use the `langCode` parameter to specify the signer language version that you want to retrieve.