List Templates

Retrieve the templates available to your account. Use the returned template_id values when creating signature requests.

Authentication

This endpoint requires a bearer token. See Authentication and API Keys.

Header	Required	Description
Authorization	required	`Bearer <BEARER_TOKEN>`

This endpoint takes no parameters.

Request body: None.

curl -X GET "https://toolkit.undersign.app/api/v1.1/templates" \
  -H "Authorization: Bearer <BEARER_TOKEN>"

A successful response uses HTTP 200 with the templates in data:

200 OK

{
  "success": true,
  "request_id": "...",
  "timestamp": "...",
  "data": []
}

Each template record in data contains:

Field	Description
template_id	Template external UUID. Use this when creating a signature request.
company_id	The company the template belongs to.
template_title	Template title.
template_file	The template's document file.
template_type	Template type (`Fillable` for sendable templates).
template_draft	Whether the template is a draft.
is_delete	Whether the template is marked for deletion.

Code	Error code	Description
`200 OK`	`-`	Templates retrieved. Internal numeric IDs are masked with UUIDs.
`429`	`RATE_LIMIT_EXCEEDED`	Exceeded 100 requests per minute. See Rate Limits.

The common workflow is to list templates, choose a template_id, then create a signature request with it:

Flow

GET /templates
  ↓
choose template_id
  ↓
POST /signature-requests

Inspect a single template's signers and fields.

Send a template with signers.