GET /communication/logs

Paginated query of message send records for the current tenant. Data is isolated by the current logged-in user (only returns the user's own send records). Supports filtering by channel (sms/email/push) and send status (pending/sent/failed/delivered). References: ePrivacy Directive 2002/58/EC, CAN-SPAM Act.

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
user_id	query	string	No				User ID (automatically filtered by current logged-in user)
channel	query	string	No				Send channel filter: sms/email/push
status	query	string	No				Send status filter: pending/sent/failed/delivered
page	query	integer	No				Page number, starting from 1 (default 1)
page_size	query	integer	No				Items per page (default 20, max 100)

Responses

Status	Description	Schema
200	Paginated query successful, returns send log summary list	dto.CommunicationLogListResponse
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.CommunicationLogListResponse

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

dto.CommunicationLogResponse

Message send log record

Field	Type	Required	Example	Constraints	Description
channel	string	No	sms
content	string	No	Your verification code is 123456
created_at	string	No	2026-04-15T10:00:00Z
error	string	No	Send timeout
id	string	No	log_abc123
provider	string	No	aliyun
recipient	string	No	138****8000
response	string	No
sent_at	string	No	2026-04-15T10:01:00Z
status	string	No	delivered
template_id	string	No	tpl_abc123
tenant_id	string	No	tnt_xyz789
updated_at	string	No	2026-04-15T10:00:00Z
user_id	string	No	usr_abc123

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