Skip to content

Signable API (1.0.0)

The Signable API provides secure and efficient access to Signable's electronic signature platform. With this RESTful API, you can send documents for signature, manage templates, track envelope status, and automate your document workflows from within your own applications.

Download OpenAPI description
openapi.json
openapi.yaml
Overview
Signable

help@signable.co.uk

License

Proprietary

Terms of Service

Languages
Servers
Mock server

https://developers.signable.app/_mock/openapi/

Production server

https://api.signable.co.uk/v1/

Partners

Manage partner integrations.

Operations

Envelopes

Send, track, and manage documents for e-signature.

Operations

Templates

Create and reuse predefined document templates.

Operations

List templates

Request

Retrieves a paginated list of all templates available in your account.

Security
basicAuth
Query
offsetinteger

The index of the first envelope to retrieve.

Default 0
Example: offset=0
limitinteger[ 1 .. 50 ]

The maximum number of envelopes to return. If more than 50 is requested, 10 will be returned instead.

Default 10
curl -i -X GET \
  -u <username>:<password> \
  'https://developers.signable.app/_mock/openapi/templates?offset=0&limit=10'

Responses

Templates list returned successfully

Bodyapplication/json
httpinteger
Example: 200
offsetinteger
Example: 0
limitinteger
Example: 10
total_templatesstring
Example: "1"
templatesArray of objects(TemplateSummary)
Response
application/json
{
  "http": 200,
  "offset": 0,
  "limit": 10,
  "total_templates": "2",
  "templates": [
    { … },
    { … }
  ]
}

Get template

Request

Retrieves metadata and configuration for a single template.

Security
basicAuth
Path
template_fingerprintstringrequired

The unique fingerprint of the template

Example: b786a173554cc06371248caf0b250704
curl -i -X GET \
  -u <username>:<password> \
  https://developers.signable.app/_mock/openapi/templates/b786a173554cc06371248caf0b250704

Responses

Template details returned successfully

Bodyapplication/json
httpinteger
Example: 200
template_idstring

Internal identifier.

Example: "53690003"
template_fingerprintstring

The unique ID used to identify this template.

Example: "b786a173554cc06371248caf0b250704"
template_titlestring

The name of the template.

Example: "Sample Contract"
template_page_totalstring

The total number of pages in the template.

Example: "1"
template_in_progressstring

The number of envelopes currently in progress that use this template.

Example: "3"
template_parties_totalstring

The number of signing parties included in the template.

Example: "1"
template_widget_urlstring(uri)

The direct URL to the hosted signing widget for this template.

Example: "https://sign.signable.app/#/widget/VG7Tsd3y6X"
template_widget_embedstring

A script snippet for embedding the signing widget into a webpage.

Example: "<iframe src='https://sign.signable.app/#/widget/VG7Tsd3y6X' frameborder='0' style='border:0;width:100%;height:100vh;' scrolling='yes'></iframe>"
template_pdf_urlstring(uri)

A direct link to download the original uploaded PDF used in the template.

Example: "https://docs.signable.co.uk/original/b786a173554cc06371248caf0b250704.pdf"
template_thumbnailsArray of strings(uri)

An array of URLs to thumbnail images for each page of the template.

template_pagesArray of strings(uri)

An array of URLs to full-size images of each page in the template.

template_uploadedstring(date-time)

The date and time the template was uploaded (in ISO 8601 format).

Example: "2025-07-01T08:40:38+0000"
template_partiesArray of objects(TemplateParty)

A list of the parties assigned to the template, including the merge fields linked to each party.

Response
application/json
{
  "http": 200,
  "template_id": "53690003",
  "template_fingerprint": "b786a173554cc06371248caf0b250704",
  "template_title": "Sample Contract",
  "template_page_total": "1",
  "template_in_progress": "3",
  "template_parties_total": "1",
  "template_widget_url": "https://sign.signable.app/#/widget/YzVsBQ5Dyj",
  "template_widget_embed": "<iframe src='https://sign.signable.app/#/widget/YzVsBQ5Dyj' frameborder='0' style='border:0;width:100%;height:100vh;' scrolling='yes'></iframe>",
  "template_pdf_url": "https://docs.signable.co.uk/original/b786a173554cc06371248caf0b250704.pdf",
  "template_thumbnails": [
    "https://docs.signable.co.uk/small/b786a173554cc06371248caf0b250704-0.jpg"
  ],
  "template_pages": [
    "https://docs.signable.co.uk/large/b786a173554cc06371248caf0b250704-0.jpg"
  ],
  "template_uploaded": "2025-07-01T08:40:38+0000",
  "template_parties": [
    { … }
  ]
}

Delete a template

Request

Deletes a template by its fingerprint.

Security
basicAuth
Path
template_fingerprintstringrequired

The unique fingerprint of the template to delete

Example: e0b3a9cbd4a6ff2cb57cfca161a39309
curl -i -X DELETE \
  -u <username>:<password> \
  https://developers.signable.app/_mock/openapi/templates/e0b3a9cbd4a6ff2cb57cfca161a39309

Responses

Template deleted successfully

Bodyapplication/json
httpinteger
Example: 200
messagestring
Example: "Sample Tenancy Contract has been removed from your template list."
template_idstring
Example: "53890528"
tempate_fingerprintstring
Example: "e0b3a9cbd4a6ff2cb57cfca161a39309"
tempate_titlestring
Example: "Sample Tenancy Contract"
Response
application/json
{
  "http": 200,
  "message": "Sample Tenancy Contract has been removed from your template list.",
  "template_id": "53890528",
  "tempate_fingerprint": "e0b3a9cbd4a6ff2cb57cfca161a38309",
  "tempate_title": "Sample Tenancy Contract"
}

Contacts

Manage contact details for signers and stakeholders.

Operations

Users

Control user accounts and roles.

Operations

Branding

Customize visual and branding settings for emails.

Operations

Settings

Configure account-wide preferences and defaults.

Operations

Webhooks

Receive real-time notifications about document events.

OperationsWebhooks