Documentation

Templates

List templates

GET/templates

Saved templates the key's workspace can generate from, most recently updated first. When truncated is true, narrow with search rather than paging.

Parameters

NameTypeDescription
searchstringOnly templates whose title contains this text.
limitintegerPage size, 1 to 200.

Request

curl "https://usepaperclerk.com/api/v1/templates?search=invoice" \
  -H "Authorization: Bearer pc_YOUR_TOKEN"

Response

JSON
{
  "workspace": "Acme Studio",
  "templates": [
    {
      "id": "4d1f0c2e-7b3a-4c1e-9d2f-1a2b3c4d5e6f",
      "title": "Consulting invoice",
      "folder_path": "Finance / Invoices",
      "updated_at": "2026-09-10T09:14:03.201Z"
    }
  ],
  "total": 1,
  "truncated": false
}
  • workspace — The connected workspace's name; a key opens exactly one.
  • folder_path — Where the template is filed, as Parent / Child; empty at the root.
  • total — How many templates match, whatever the limit.
  • truncated — True when total exceeds the page.