---
title: "List all templates in project"
method: GET
path: "/v1/projects/{projectId}/kakaotalk/senders/{plusFriendId}/templates"
tags: ["KakaoTalk Templates"]
---

# List all templates in project

`GET /v1/projects/{projectId}/kakaotalk/senders/{plusFriendId}/templates`

Returns a paginated list of templates for the specified project. If no page token is supplied then the first `50` templates are returned in alphabetical order.

## Path parameters

- `projectId` string, required
- `plusFriendId` string, required

## Query parameters

- `filterStates` string[]
- `filterStatuses` string[]
- `pageSize` number
- `pageToken` string
- `templateName` string

## Response `200`

List of templates

- KakaotalkTemplateListDto
  - `totalSize` number, required — Total size of the entries matching the search query.
  - `pageSize` number, required — Requested size of the page.
  - `previousPageToken` string — Encoded token to use in list request to fetch previous batch of entries.
  - `nextPageToken` string — Encoded token to use in list request to fetch next batch of entries.
  - `templates` KakaotalkTemplateDto[], required — List of templates
    - `id` string — The unique ID of the template.
    - `code` string, required — Registered delivery template code
    - `state` 'APPROVED' | 'REJECTED' — The current state of the template.
    - `changes` KakaotalkTemplateChangesDto
      - `status` 'DRAFT' | 'IN_PROGRESS' | 'REJECTED', required — Current status of the pending changes
      - `details` union, required — Template details and information.
        - object
          - `language` 'AF' | 'AR' | 'AZ' | 'BG' | 'BN' | 'CA' | 'CS' | 'DA' | 'DE' | 'EL' | 'EN' | 'EN_GB' | 'EN_US' | 'ES' | 'ES_AR' | 'ES_ES' | 'ES_MX' | 'ET' | 'FA' | 'FI' | 'FIL' | 'FR' | 'GA' | 'GU' | 'HA' | 'HE' | 'HI' | 'HR' | 'HU' | 'ID' | 'IT' | 'JA' | 'KA' | 'KK' | 'KN' | 'KO' | 'KY_KG' | 'LO' | 'LT' | 'LV' | 'MK' | 'ML' | 'MR' | 'MS' | 'NB' | 'NL' | 'PA' | 'PL' | 'PT_BR' | 'PT_PT' | 'RO' | 'RU' | 'RW_RW' | 'SK' | 'SL' | 'SQ' | 'SR' | 'SV' | 'SW' | 'TA' | 'TE' | 'TH' | 'TR' | 'UK' | 'UR' | 'UZ' | 'VI' | 'ZH_CN' | 'ZH_HK' | 'ZH_TW' | 'ZU' | 'UNRECOGNIZED', required — Template language
          - `messageType` 'AD_INCLUDED' | 'BASIC' | 'EXTRA_INFORMATION' | 'MIXED' | 'TEMPLATE_MESSAGE_TYPE_UNSPECIFIED' | 'UNRECOGNIZED', required — Types of template message
          - `emphasizeType` 'EMPHASIZE_TYPE_IMAGE' | 'EMPHASIZE_TYPE_NONE' | 'EMPHASIZE_TYPE_TEXT' | 'EMPHASIZE_TYPE_UNSPECIFIED' | 'UNRECOGNIZED', required — Types of emphasized template
          - `categoryCode` string, required — Template category code
          - `securityFlag` boolean, required — Security template
          - `name` string, required — Button name
          - `content` string — Template body
          - `extra` string — Additional template information
          - `ad` string — Request for consent of receiving within template or simple ad phrases
          - `title` string — Template title
          - `subtitle` string — Auxiliary template phrase
          - `imageName` string — Image name (name of uploaded file)
          - `imageUrl` string, url — Image URL
          - `buttons` KakaotalkButtonDto[], required — List of buttons
            - `ordering` number — Button sequence
            - `type` 'APP_LINK' | 'BOT_FOR_CONSULTATION' | 'BOT_KEYWORD' | 'BOT_TRANSFER' | 'BUSINESS_FORM' | 'BUTTON_TYPE_UNSPECIFIED' | 'CHANNEL_ID_ADDED' | 'DELIVERY_SEARCH' | 'IMAGE_SECURE_TRANSMISSION_PLUGIN_ID' | 'MESSAGE_DELIVERY' | 'ONE_CLICK_PAYMENT_PLUGIN' | 'PERSONAL_INFORMATION_USE_PLUGIN_ID' | 'WEB_LINK' | 'UNRECOGNIZED' — Button type
            - `name` string — Button name
            - `linkMo` string, url — Mobile web link
            - `linkPc` string, url — PC web link
            - `schemeIos` string — iOS app link
            - `schemeAndroid` string — Android app link
        - object
          - `language` 'AF' | 'AR' | 'AZ' | 'BG' | 'BN' | 'CA' | 'CS' | 'DA' | 'DE' | 'EL' | 'EN' | 'EN_GB' | 'EN_US' | 'ES' | 'ES_AR' | 'ES_ES' | 'ES_MX' | 'ET' | 'FA' | 'FI' | 'FIL' | 'FR' | 'GA' | 'GU' | 'HA' | 'HE' | 'HI' | 'HR' | 'HU' | 'ID' | 'IT' | 'JA' | 'KA' | 'KK' | 'KN' | 'KO' | 'KY_KG' | 'LO' | 'LT' | 'LV' | 'MK' | 'ML' | 'MR' | 'MS' | 'NB' | 'NL' | 'PA' | 'PL' | 'PT_BR' | 'PT_PT' | 'RO' | 'RU' | 'RW_RW' | 'SK' | 'SL' | 'SQ' | 'SR' | 'SV' | 'SW' | 'TA' | 'TE' | 'TH' | 'TR' | 'UK' | 'UR' | 'UZ' | 'VI' | 'ZH_CN' | 'ZH_HK' | 'ZH_TW' | 'ZU' | 'UNRECOGNIZED' — Template language
          - `messageType` 'AD_INCLUDED' | 'BASIC' | 'EXTRA_INFORMATION' | 'MIXED' | 'TEMPLATE_MESSAGE_TYPE_UNSPECIFIED' | 'UNRECOGNIZED' — Types of template message
          - `emphasizeType` 'EMPHASIZE_TYPE_IMAGE' | 'EMPHASIZE_TYPE_NONE' | 'EMPHASIZE_TYPE_TEXT' | 'EMPHASIZE_TYPE_UNSPECIFIED' | 'UNRECOGNIZED' — Types of emphasized template
          - `categoryCode` string — Template category code
          - `securityFlag` boolean — Security template
          - `name` string — Button name
          - `content` string — Template body
          - `extra` string — Additional template information
          - `ad` string — Request for consent of receiving within template or simple ad phrases
          - `title` string — Template title
          - `subtitle` string — Auxiliary template phrase
          - `imageName` string — Image name (name of uploaded file)
          - `imageUrl` string, url — Image URL
          - `buttons` KakaotalkButtonDto[] — List of buttons
            - `ordering` number — Button sequence
            - `type` 'APP_LINK' | 'BOT_FOR_CONSULTATION' | 'BOT_KEYWORD' | 'BOT_TRANSFER' | 'BUSINESS_FORM' | 'BUTTON_TYPE_UNSPECIFIED' | 'CHANNEL_ID_ADDED' | 'DELIVERY_SEARCH' | 'IMAGE_SECURE_TRANSMISSION_PLUGIN_ID' | 'MESSAGE_DELIVERY' | 'ONE_CLICK_PAYMENT_PLUGIN' | 'PERSONAL_INFORMATION_USE_PLUGIN_ID' | 'WEB_LINK' | 'UNRECOGNIZED' — Button type
            - `name` string — Button name
            - `linkMo` string, url — Mobile web link
            - `linkPc` string, url — PC web link
            - `schemeIos` string — iOS app link
            - `schemeAndroid` string — Android app link
    - `details` KakaotalkTemplateDetailsDto
      - `language` 'AF' | 'AR' | 'AZ' | 'BG' | 'BN' | 'CA' | 'CS' | 'DA' | 'DE' | 'EL' | 'EN' | 'EN_GB' | 'EN_US' | 'ES' | 'ES_AR' | 'ES_ES' | 'ES_MX' | 'ET' | 'FA' | 'FI' | 'FIL' | 'FR' | 'GA' | 'GU' | 'HA' | 'HE' | 'HI' | 'HR' | 'HU' | 'ID' | 'IT' | 'JA' | 'KA' | 'KK' | 'KN' | 'KO' | 'KY_KG' | 'LO' | 'LT' | 'LV' | 'MK' | 'ML' | 'MR' | 'MS' | 'NB' | 'NL' | 'PA' | 'PL' | 'PT_BR' | 'PT_PT' | 'RO' | 'RU' | 'RW_RW' | 'SK' | 'SL' | 'SQ' | 'SR' | 'SV' | 'SW' | 'TA' | 'TE' | 'TH' | 'TR' | 'UK' | 'UR' | 'UZ' | 'VI' | 'ZH_CN' | 'ZH_HK' | 'ZH_TW' | 'ZU' | 'UNRECOGNIZED', required — Template language
      - `messageType` 'AD_INCLUDED' | 'BASIC' | 'EXTRA_INFORMATION' | 'MIXED' | 'TEMPLATE_MESSAGE_TYPE_UNSPECIFIED' | 'UNRECOGNIZED', required — Types of template message
      - `emphasizeType` 'EMPHASIZE_TYPE_IMAGE' | 'EMPHASIZE_TYPE_NONE' | 'EMPHASIZE_TYPE_TEXT' | 'EMPHASIZE_TYPE_UNSPECIFIED' | 'UNRECOGNIZED', required — Types of emphasized template
      - `categoryCode` string, required — Template category code
      - `securityFlag` boolean, required — Security template
      - `name` string, required — Button name
      - `content` string — Template body
      - `extra` string — Additional template information
      - `ad` string — Request for consent of receiving within template or simple ad phrases
      - `title` string — Template title
      - `subtitle` string — Auxiliary template phrase
      - `imageName` string — Image name (name of uploaded file)
      - `imageUrl` string, url — Image URL
      - `buttons` KakaotalkButtonDto[], required — List of buttons
        - `ordering` number — Button sequence
        - `type` 'APP_LINK' | 'BOT_FOR_CONSULTATION' | 'BOT_KEYWORD' | 'BOT_TRANSFER' | 'BUSINESS_FORM' | 'BUTTON_TYPE_UNSPECIFIED' | 'CHANNEL_ID_ADDED' | 'DELIVERY_SEARCH' | 'IMAGE_SECURE_TRANSMISSION_PLUGIN_ID' | 'MESSAGE_DELIVERY' | 'ONE_CLICK_PAYMENT_PLUGIN' | 'PERSONAL_INFORMATION_USE_PLUGIN_ID' | 'WEB_LINK' | 'UNRECOGNIZED' — Button type
        - `name` string — Button name
        - `linkMo` string, url — Mobile web link
        - `linkPc` string, url — PC web link
        - `schemeIos` string — iOS app link
        - `schemeAndroid` string — Android app link
    - `created` string — The UTC Date Time in ISO 8601 for when the template was created.
    - `modified` string — The UTC Date Time in ISO 8601 for when the template was last modified.

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `404` — NotFound
- `500` — InternalServerError

---

[API](https://skmtc.net/sinch/apis/provisioning-api.md) · [All operations](https://skmtc.net/sinch/apis/provisioning-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinch/provisioning-api/revisions/c78a716de420/schema)