---
title: "List templates"
method: GET
path: "/api/v1/templates"
tags: ["Template"]
---

# List templates

`GET /api/v1/templates`

Returns a paginated list of templates that the authenticated user has READ permissions on. Each template returned is the current working version. Results can be filtered by title, site, and archive status. Use hostId='*' to search across all sites.

## Query parameters

- `filter` string
- `page` integer
- `per_page` integer
- `orderby` string
- `direction` string
- `host` string
- `archive` boolean

## Response `200`

Paginated list of templates returned successfully

- ResponseEntityListTemplateView
  - `errors` ErrorEntity[]
    - `errorCode` string
    - `message` string
    - `fieldName` string
  - `entity` Template[]
    - `getiDate` string, date-time
    - `type` string
    - `owner` string
    - `inode` string
    - `identifier` string
    - `source` 'UNKNOWN' | 'DB' | 'FILE'
    - `title` string
    - `friendlyName` string
    - `modDate` string, date-time
    - `modUser` string
    - `sortOrder` integer
    - `showOnMenu` boolean
    - `body` string
    - `selectedimage` string
    - `image` string
    - `drawed` boolean
    - `drawedBody` string
    - `countAddContainer` integer
    - `countContainers` integer
    - `headCode` string
    - `theme` string
    - `themeName` string
    - `header` string
    - `footer` string
    - `template` boolean
    - `isTemplate` boolean
    - `anonymous` boolean
    - `versionType` string
    - `permissionId` string
    - `versionId` string
    - `working` boolean
    - `deleted` boolean
    - `archived` boolean
    - `live` boolean
    - `locked` boolean
    - `name` string
    - `permissionType` string
    - `idate` string, date-time
    - `categoryId` string
    - `new` boolean
    - `parents` object[]
  - `messages` MessageEntity[]
    - `message` string
  - `i18nMessagesMap` object
  - `permissions` string[]
  - `pagination` Pagination
    - `currentPage` integer
    - `perPage` integer
    - `totalEntries` integer

## Other responses

- `401` — Authentication required

---

[API](https://skmtc.dev/jostens/apis/dotcms-rest-api.md) · [All operations](https://skmtc.dev/jostens/apis/dotcms-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jostens/dotcms-rest-api/revisions/a088fe9f515c/schema)