Skip to main content

Get Templates and Folders

The Get Templates and Folders endpoint lists the templates and folders at the root of your TurboDocx workspace, including each item's ID, name, parent folder, and tags. By default it returns only root-level items; pass type=template to enumerate every template across all folders. It is the starting point for most integrations: call it to discover the TemplateId values you pass to document generation, or to build a template picker inside your own app.

When to use it​

Use this endpoint to populate a "choose a template" dropdown, sync your template library into another system, or look up the ID of a template before generating a document or deleting it. Results include each item's tags by default (showTags defaults to true); page through large libraries with limit and offset.

Example request​

curl "https://api.turbodocx.com/template-item?limit=25&offset=0" \
  -H "Authorization: Bearer $TURBODOCX_API_KEY" \
  -H "x-rapiddocx-org-id: $TURBODOCX_ORG_ID" \
  -H "Accept: application/json"

Example response​

Responses are wrapped in a data object. results is the array of items and totalRecords is the total count for paging.

{
  "data": {
    "results": [
      {
        "id": "2b8f1c9e-4d3a-4a7c-9f21-6b0d5e9a1c34",
        "name": "SOW Template",
        "description": "Standard statement of work",
        "type": "template",
        "isActive": true,
        "templateFolderId": null,
        "createdBy": "f5e6d7c8-9a0b-4c1d-2e3f-4a5b6c7d8e9f",
        "email": "jane@example.com",
        "deliverableCount": 12,
        "templateCount": 0,
        "fileSize": 48213,
        "fileType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
        "createdOn": "2026-05-01T14:22:10.000Z",
        "updatedOn": "2026-05-01T14:22:10.000Z",
        "tags": ["sales", "legal"]
      },
      {
        "id": "7c1a0b52-9e88-4f0d-b3a2-1d4c6f8e2a90",
        "name": "Proposals",
        "type": "folder",
        "isActive": true,
        "templateFolderId": null,
        "templateCount": 5,
        "deliverableCount": 0
      }
    ],
    "totalRecords": 2
  }
}

Each item's type is either "template" or "folder". createdBy is the creator's user ID (a UUID), not a display name; use email for the human identity. fileType is the file's MIME type (for example application/vnd.openxmlformats-officedocument.wordprocessingml.document for a DOCX). The tags array is included when showTags is true (the default).

Pagination and filtering​

Page with limit (default 9) and offset (default 0): request successive pages by increasing offset by limit, and use totalRecords to know when to stop. Other supported query parameters:

  • query — free-text search across template names
  • selectedTags — one or more tag IDs (GUIDs) to filter by
  • column0 + order0 — sort by name, createdOn, updatedOn, email, or templateCount, in asc or desc order
  • showTags — set to false to omit the tags array

Common errors​

StatusWhenResponse body
401Missing or invalid API key/token, or the organization cannot be resolvedEmpty (status only)
400A query parameter fails validation (for example a non-numeric limit){ "message", "type": "ValidationError", "data": { "errors": [...] } }
Last updated on