API reference

Templates

Reusable documents with roles. Make them in the app, then send them with the API.

Endpoints · 2

GET List templates
GET Retrieve a template

The object

Field	Type	Description
`id`	string	Unique ID, starting with tpl_.
`object`	string	Always "template".
`name`	string	The template’s name.
`message`	string	The default message.
`signing_order`	enum	sequential or parallel.
`files, page_count`		As on documents.
`roles`	array	Each with template_role (fill it when sending), role (signer or cc), fixed_email (set when the role always goes to the same address) and signing_order.
`folder_id`	string or null	Its folder.
`created_at, updated_at`	timestamp

GET/templates

List templates

Newest first.

Parameter	Type		Description
`limit`	integer	optional	How many objects to return, 1 to 100. Default 20.
`starting_after`	string	optional	The next_cursor from the previous page. Leave it out for the first page.

Request

bash

curl "https://api.esorasign.com/v1/templates" \
  -H "Authorization: Bearer $ESORA_API_KEY"

Response

json

{
  "object": "list",
  "data": [
    {
      "id": "tpl_2zg4mZaouqKLiMcVbpT4r5",
      "object": "template",
      "name": "Mutual NDA",
      "message": "Please sign the NDA before our call.",
      "signing_order": "sequential",
      "files": [
        { "id": "file_1wQy0bN5bYc8xV0kH4mZtR", "name": "Mutual NDA.pdf", "content_type": "application/pdf", "size": 96420, "page_count": 3 }
      ],
      "page_count": 3,
      "roles": [
        { "template_role": "Client", "role": "signer", "fixed_email": null, "signing_order": 1 },
        { "template_role": "Account manager", "role": "signer", "fixed_email": null, "signing_order": 2 }
      ],
      "folder_id": null,
      "created_at": "2026-10-12T16:20:03.000Z",
      "updated_at": "2026-10-12T16:31:47.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

GET/templates/{id}

Retrieve a template

To send it, see Create a document from a template.

Request

bash

curl "https://api.esorasign.com/v1/templates/tpl_2zg4mZaouqKLiMcVbpT4r5" \
  -H "Authorization: Bearer $ESORA_API_KEY"

Response

json

{
  "id": "tpl_2zg4mZaouqKLiMcVbpT4r5",
  "object": "template",
  "name": "Mutual NDA",
  "message": "Please sign the NDA before our call.",
  "signing_order": "sequential",
  "files": [
    { "id": "file_1wQy0bN5bYc8xV0kH4mZtR", "name": "Mutual NDA.pdf", "content_type": "application/pdf", "size": 96420, "page_count": 3 }
  ],
  "page_count": 3,
  "roles": [
    { "template_role": "Client", "role": "signer", "fixed_email": null, "signing_order": 1 },
    { "template_role": "Account manager", "role": "signer", "fixed_email": null, "signing_order": 2 }
  ],
  "folder_id": null,
  "created_at": "2026-10-12T16:20:03.000Z",
  "updated_at": "2026-10-12T16:31:47.000Z"
}