# Get company settings

Your Signable account settings control how documents are delivered, signed, and managed across your team.
This section of the API lets you retrieve and update your company's signing preferences, email notification rules, signature formats, and more—giving you full control over how your documents behave.
Settings can be accessed via the API or in the Signable web app under Company Settings > Preferences.


Endpoint: GET /settings
Version: 1.0.0
Security: basicAuth

## Response 200 fields (application/json):

  - `http` (integer)
    Example: 200

  - `setting_signature_more_info` (boolean)
    If enabled, the signature will display the signer name and timestamp under each signature block on the generated Envelope PDF.
    Example: true

  - `setting_signature_format_default` (string)
    Which signature format is offered by default. Accepted values: , , or .
    Example: "typed"

  - `setting_signature_format_accepted` (string)
    Comma-separated list of signature formats your account accepts. Valid values: , , .
    Example: "typed,drawn,upload"

  - `setting_email_pdf_attach` (boolean)
    If enabled, a PDF copy of the envelope will be attached to emails sent to recipients. If disabled, recipients must instead use a link in the email to view and download the envelope.
    Example: true

  - `setting_email_pdf_attach_sender` (boolean)
    If enabled, a PDF copy of the signed envelope will be attached to the sign-complete notification email sent to your company email address. If disabled, the envelope must be downloaded from the app.
    Example: true

  - `setting_email_envelope_open` (boolean)
    If enabled, an email notification will be sent when someone opens the envelope.
    Example: true

  - `setting_email_main_email` (boolean)
    If enabled, notifications (signed, rejected, cancelled) are sent to your company’s main email address.
    Example: true

  - `setting_email_return_address_user` (boolean)
    If enabled, the "Return Email" will be set to the user who sent the envelope, rather than the main company email. If disabled, the "Return Email" will be set to your main company email address. Regardless of this property, emails will always be sent from document@signable.co.uk.
    Example: true

  - `setting_signing_consumer_regulations_act` (boolean)
    Enables [Consumer Contract Regulations 2013 compliance](http://www.legislation.gov.uk/uksi/2013/3134/pdfs/uksi_20133134_en.pdf) for your account. Only set this to 'Yes' if you believe that you need this enabled. This setting will change some of the terminology on the signing page to become compliant with this Act.

  - `setting_signing_questions` (boolean)
    If enabled, signers can send you questions or comments directly from the signing page.
    Example: true

  - `setting_pdf_audit_trail_hide` (boolean)
    If enabled, all party email addresses and mobile numbers will be hidden on the signing page and PDF certificate audit trail.
    Example: true

  - `setting_all_at_once_default` (boolean)
    If enabled, envelopes are sent to all parties simultaneously by default (all-at-once signing). If disabled, envelopes are sent to the first party only (one-at-a-time signing). Default is .
    Example: true

  - `setting_signing_tooltips` (boolean)
    If enabled, tooltip hints will be shown when a signer attempts to sign a document.