GET /communication/templates

Paginated query of message template list for the current tenant. Supports filtering by send channel (sms/email/push), activation status, and keyword (template name/code). References: ePrivacy Directive 2002/58/EC, CAN-SPAM Act.

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
channel	query	string	No				Channel filter: sms/email/push
is_active	query	boolean	No				Activation status filter: true/false
keyword	query	string	No				Keyword search (matches template name or code)
page	query	integer	No				Page number, starting from 1 (default 1)
page_size	query	integer	No				Items per page (default 20)

Responses

Status	Description	Schema
200	Query successful, returns template list	dto.TemplateListResponse
400	Invalid request parameters	dto.SimpleResponse
401	Unauthenticated or invalid token	dto.SimpleResponse
403	Insufficient permissions to access this resource	dto.SimpleResponse
500	Internal server error	dto.SimpleResponse

Referenced Schemas

dto.PageInfo

Field	Type	Required	Example	Constraints	Description
has_next	boolean	No			HasNext indicates whether there is a next page
has_prev	boolean	No			HasPrev indicates whether there is a previous page
page	integer	No			Page is the current page number (1-based)
page_size	integer	No			PageSize is the number of items per page
total	integer	No			Total is the total number of items across all pages
total_pages	integer	No			TotalPages is the total number of pages

dto.SimpleResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
message	string	No
timestamp	string	No

dto.TemplateListResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
items	array of See dto.TemplateResponse	No			Unified use of items
message	string	No
pagination	object	No			Pagination information (nested object)
timestamp	string	No
total	integer	No			Total count (flattened for direct reading)

dto.TemplateResponse

Template data

Field	Type	Required	Example	Constraints	Description
channel	string	No	sms
code	string	No	verify_code
content	string	No	Your verification code is {code}, valid for 5 minutes.
content_type	string	No	text
created_at	string	No	2026-04-15T10:00:00Z
description	string	No	Used to send login verification codes.
id	string	No	tpl_abc123
is_active	boolean	No	True
name	string	No	Verification code template
subject	string	No	Verification code notification
tenant_id	string	No	tnt_xyz789
updated_at	string	No	2026-04-15T10:00:00Z
variables	array of string	No	['["code"]']
version	integer	No	1