--- title: "List all templates" method: GET path: "/templates" tags: ["Templates"] --- # List all templates `GET /templates` The API endpoint provides the ability to retrieve a list of available document templates. ## Query parameters - `q` string - `slug` string - `external_id` string - `folder` string - `archived` boolean - `limit` integer - `after` integer - `before` integer ## Response `200` OK - object - `data` object[], required — List of templates. - `id` integer, required — Unique identifier of the document template. - `slug` string, required — Unique slug of the document template. - `name` string, required — The name of the template. - `preferences` object, required — Template preferences. - `schema` object[], required — List of documents attached to the template. - `attachment_uuid` string, required — Unique identifier of attached document to the template. - `name` string, required — Name of the attached document to the template. - `fields` object[], required — List of fields to be filled in the template. - `uuid` string, required — Unique identifier of the field. - `submitter_uuid` string, required — Unique identifier of the submitter that filled the field. - `name` string, required — Field name. - `type` 'heading' | 'text' | 'signature' | 'initials' | 'date' | 'number' | 'image' | 'checkbox' | 'multiple' | 'file' | 'radio' | 'select' | 'cells' | 'stamp' | 'payment' | 'phone' | 'verification' | 'kba' | 'strikethrough', required — Type of the field (e.g., text, signature, date, initials). - `required` boolean, required — Indicates if the field is required. - `preferences` object — Field display preferences. - `font_size` integer — Font size of the field value in pixels. - `font_type` string — Font type of the field value. - `font` string — Font family of the field value. - `color` string — Font color of the field value. - `background` string — Field box background color. - `align` string — Horizontal alignment of the field text value. - `valign` string — Vertical alignment of the field text value. - `format` string — The data format for different field types. - `price` number — Price value of the payment field. Only for payment fields. - `currency` string — Currency value of the payment field. Only for payment fields. - `mask` boolean — Indicates if the field is masked on the document. - `reasons` string[] — An array of signature reasons to choose from. - `areas` object[], required — List of areas where the field is located in the document. - `x` number, required — X coordinate of the area where the field is located in the document. - `y` number, required — Y coordinate of the area where the field is located in the document. - `w` number, required — Width of the area where the field is located in the document. - `h` number, required — Height of the area where the field is located in the document. - `attachment_uuid` string, required — Unique identifier of the attached document where the field is located. - `page` integer, required — Page number of the attached document where the field is located. - `submitters` object[], required — The list of submitters for the template. - `name` string, required — The name of the submitter. - `uuid` string, required — Unique identifier of the submitter. - `author_id` integer, required — Unique identifier of the author of the template. - `archived_at` string, nullable — Date and time when the template was archived. - `created_at` string, required — The date and time when the template was created. - `updated_at` string, required — The date and time when the template was last updated. - `source` 'native' | 'api' | 'embed', required — Source of the template. - `external_id` string, nullable, required — Your application-specific unique string key to identify this template within your app. - `folder_id` integer, required — Unique identifier of the folder where the template is located. - `folder_name` string, required — Folder name where the template is located. - `shared_link` boolean — Indicates if the template is accessible by link. - `author` object, required - `id` integer, required — Unique identifier of the author. - `first_name` string, required — First name of the author. - `last_name` string, required — Last name of the author. - `email` string, required — Author email. - `documents` object[], required — List of documents attached to the template. - `id` integer, required — Unique identifier of the document. - `uuid` string, required — Unique identifier of the document. - `url` string, required — URL of the document. - `preview_image_url` string, required — Document preview image URL. - `filename` string, required — Document filename. - `pagination` object, required - `count` integer, required — Templates count. - `next` integer, nullable, required — The ID of the template after which the next page starts. - `prev` integer, nullable, required — The ID of the template before which the previous page ends. ## Changes - **2026-07-17** `c209c00c2386` — 1 warning - added the new `kba` enum value to the `data/items/fields/items/type` response property for the response status `200` - **2025-12-15** `c684e0b4cc66` — 1 warning, 2 info - added the new `strikethrough` enum value to the `data/items/fields/items/type` response property for the response status `200` - added the optional property `data/items/fields/items/preferences/background` to the response with the `200` status - added the optional property `data/items/fields/items/preferences/reasons` to the response with the `200` status - **2025-06-26** `ddfeff66ea4f` — 1 info - added the optional property `data/items/shared_link` to the response with the `200` status - **2025-05-18** `0d8d180a4ed5` — 4 breaking, 3 warning, 2 info - the response property `data/items/archived_at` became nullable for the status `200` - the response property `data/items/external_id` became nullable for the status `200` - the response property `pagination/next` became nullable for the status `200` - the response property `pagination/prev` became nullable for the status `200` - …5 more [Change history](https://skmtc.dev/docusealco/apis/docuseal-api/changes/templates/get.md) --- [API](https://skmtc.dev/docusealco/apis/docuseal-api.md) · [All operations](https://skmtc.dev/docusealco/apis/docuseal-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/docusealco/docuseal-api/revisions/c209c00c2386/schema)