---
title: "List all templates"
method: GET
path: "/templates"
tags: ["Templates"]
---

# List all templates

`GET /templates`

List all templates for a workspace

## Query parameters

- `after` string, nullable
- `before` string, nullable
- `channel_id` string, nullable
- `folder_id` string, nullable
- `limit` integer
- `type` 'generic_template' | 'whats_app_template'

## Response `200`

OK

- PATemplateNodePagedDocsExample
  - `url` string
  - `results` PATemplateNodeDTO[]
    - `id` string — The ID of the template
    - `status` 'submitted' | 'approved' | 'rejected' | 'pending' | 'external_deleted' | 'unknown' | 'draft' | 'missing_after_migration'
    - `name` string — The name of the template
    - `content` union — The content definition of the template
      - object
        - `body` string — The body text of the generic template
        - `file_ids` FileDTO[] — The files attached to the generic template
          - `blurhash` string
          - `content_type` string
          - `created_at` string, date-time
          - `file_size_bytes` integer
          - `file_url` string
          - `id` string
          - `name` string
          - `thumbnail_url` string
          - `usage_type` string
        - `type` 'generic_template' | 'whats_app_template'
        - `variables` union[] — The variables available in the generic template
          - union
            - TEMPLATEVARIABLESTATIC
              - …
            - TEMPLATEVARIABLECONTACTATTRIBUTE
              - …
      - object
        - `body` string — The body text of the WhatsApp template
        - `buttons` union[] — The buttons configured for the WhatsApp template
          - union
            - TEMPLATEWHATSAPPBUTTONPHONENUMBER
              - …
            - TEMPLATEWHATSAPPBUTTONQUICKREPLY
              - …
            - TEMPLATEWHATSAPPBUTTONSTATICURL
              - …
            - TEMPLATEWHATSAPPBUTTONDYNAMICURL
              - …
        - `category` 'account_update' | 'payment_update' | 'personal_finance_update' | 'shipping_update' | 'reservation_update' | 'issue_resolution' | 'appointment_update' | 'transportation_update' | 'ticket_update' | 'alert_update' | 'auto_reply' | 'transactional' | 'marketing' | 'otp' | 'authentication' | 'utility'
        - `footer` string — The optional footer of the WhatsApp template
        - `header` union — The optional header of the WhatsApp template
          - TEMPLATEWHATSAPPHEADERTEXT
            - `type` 'text'
            - `value` string — The text value of the WhatsApp template header
          - TEMPLATEWHATSAPPHEADERIMAGE
            - `file_id` string — The file ID used for the image header
            - `type` 'image'
          - TEMPLATEWHATSAPPHEADERVIDEO
            - `file_id` string — The file ID used for the video header
            - `type` 'video'
          - TEMPLATEWHATSAPPHEADERDOCUMENT
            - `file_id` string — The file ID used for the document header
            - `type` 'document'
        - `track_links` boolean — Whether links in the template are tracked
        - `type` 'generic_template' | 'whats_app_template'
        - `variables` union[] — The variables available in the WhatsApp template
          - union
            - TEMPLATEVARIABLESTATIC
              - …
            - TEMPLATEVARIABLECONTACTATTRIBUTE
              - …
    - `folder` object, nullable — The folder the template belongs to
      - `id` string — The ID of the template folder
      - `name` string — The name of the template folder
      - `parent_id` string, nullable — The ID of the parent folder
    - `channels` PATemplateNodeChannelDTO[] — The channels associated with the template
      - `id` string — The ID of the channel
      - `name` string — The name of the channel
      - `url` string — The URL of the channel resource
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `url` string — The URL of the template resource
  - `pagination` Pagination
    - `next_cursor` string, nullable
    - `previous_cursor` string, nullable
    - `next_url` string, nullable
    - `previous_url` string, nullable

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

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