Skip to content

List office templates

GET/office/templates

Returns a paginated list of all document templates for the tenant, ordered by most recently updated. Includes the published version and the latest draft version for each template. Use to populate the template library or feed a template picker in document creation flows.

Request

Query parameters

NameTypeRequiredDescription
statusstringNo

Filter by template publication status.

One of: "draft", "published", "archived"

bindingstringNo

Filter templates by their merge-field binding context (e.g. "invoice", "contract").

pageintegerNo

Default: 1

Responses

200 Paginated list of office templates

Content type application/json, object.

FieldTypeRequiredDescription
dataarray of object · OfficeTemplateV1No
data[].idintegerNo

Auto-incremented primary key.

data[].namestringNo

Human-readable template name.

data[].statusstringNo

Current publication status.

One of: "draft", "published", "archived"

data[].bindingstringNo

The data binding context this template is designed for (e.g. "invoice", "contract").

data[].template_formatstringNo

Source format of the template body.

One of: "html", "docx", "odt"

data[].output_formatsarray of stringNo

List of output formats that render jobs for this template will produce.

data[].current_versionintegerNo

Latest draft version number.

data[].published_versioninteger, nullableNo

Currently active published version number. Null if never published.

data[].notesstring, nullableNo
data[].created_atstring (date-time)No
data[].updated_atstring (date-time)No
metaobject · PaginationMetaNo
meta.current_pageintegerNo
meta.per_pageintegerNo
meta.totalintegerNo

Example

{
  "data": [
    {
      "id": 3,
      "name": "Standard Invoice Template",
      "status": "published",
      "binding": "invoice",
      "current_version": 4,
      "published_version": 3,
      "output_formats": [
        "pdf",
        "docx"
      ],
      "created_at": "2025-10-01T00:00:00Z",
      "updated_at": "2026-03-15T14:00:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "total": 11
  }
}

Example request

curl -X GET "https://{tenant}.faciotech.net/api/v1/office/templates" \
  -H "Accept: application/json"
Loading