--- 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` ## Request - Base URL: `https://provisioning.api.sinch.com` - URL: `https://provisioning.api.sinch.com/v1/projects/{projectId}/kakaotalk/senders/{plusFriendId}/templates` - Auth: HTTP basic and HTTP bearer and OAuth 2 - Client credentials - Token URL: `https://auth.sinch.com/oauth2/token` 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` KakaotalkTemplateStatesEnum[] - `filterStatuses` KakaotalkTemplateStatusesEnum[] - `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 ## Changes > 17 revisions in range; 1 not diffed. - **2026-09-01** `c6a937922d10`: 18 breaking, 328 info - the response's body type changed from no type to `object` for status `400` - the response's body type changed from no type to `object` for status `401` - the response's body type changed from no type to `object` for status `404` - the response's body type changed from no type to `object` for status `500` - …342 more [Operation history](https://skmtc.dev/sinch/apis/provisioning-api/changes/v1/projects/:projectId/kakaotalk/senders/:plusFriendId/templates/get.md) --- [API](https://skmtc.dev/sinch/apis/provisioning-api.md) - [All operations](https://skmtc.dev/sinch/apis/provisioning-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sinch/apis/provisioning-api/revisions/90d78b3a8575?raw)