Get list of news samples
POST /ListTemplates HTTP/1.1
Host: $BASE_URL.Zalo
Content-Type: application/json
Accept: */*
Content-Length: 225
{
"filter": {
"date_from": "2025-08-01T18:57:26.166Z",
"date_to": "2025-08-01T18:57:26.166Z",
"oa_id": "text",
"template_id": 1,
"template_name": "text",
"type": "unknown"
},
"paging": {
"after": "text",
"before": "text",
"limit": 1,
"sort": "text"
}
}
A successful response
{
"paging": {
"after": "text",
"before": "text",
"limit": 1,
"next": "text",
"prev": "text",
"sort": "text"
},
"templates": [
{
"apply_template_quota": true,
"created_at": "2025-08-01T18:57:26.166Z",
"preview_url": "text",
"price": 1,
"template_daily_quota": 1,
"template_id": 1,
"template_name": "text",
"template_params": [
{
"accept_null": true,
"max_length": 1,
"min_length": 1,
"name": "text",
"require": true,
"type": "text"
}
],
"template_quality": "unknown",
"template_remaining_quota": 1,
"template_status": "unknown",
"template_tag": "unknown",
"timeout": 1,
"type": "unknown",
"updated_at": "2025-08-01T18:57:26.166Z"
}
]
}
Request:
curl --location '$BASE_URL.Zalo/ListTemplates' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $API_KEY' \
--data '{
"filter": {
"date_from": "2023-07-24T14:15:22Z",
"date_to": "2023-08-02T14:15:22Z"
},
"paging": {
"limit": 50
}
}'
Response:
{
"paging": {
"after": "string",
"before": "string",
"limit": 0,
"next": "string",
"prev": "string",
"sort": "string"
},
"templates": [
{
"apply_template_quota": true,
"created_at": "2019-08-24T14:15:22Z",
"price": 0,
"template_daily_quota": 0,
"template_id": 0,
"template_name": "string",
"template_params": [
{
"accept_null": true,
"max_length": 0,
"min_length": 0,
"name": "string",
"require": true,
"type": "string"
}
],
"template_quality": "unknown",
"template_remaining_quota": 0,
"template_status": "unknown",
"template_tag": "unknown",
"timeout": 0,
"type": "unknown",
"updated_at": "2019-08-24T14:15:22Z"
}
]
}
Request body structure
id
int64
OA ID
type
string
Enum: "unknown" "text" "otp" "table" "rating"
template_id
integer
ID of the message
template_name
string
Template name
date_from
string<date-time>
Start date
date_to
string<date-time>
End date
Return data attribute structure
template_id
integer
ID of the message
template_name
string
Name of the message
price
integer
Unit price of the ad
timeout
integer
Sample charge time
apply_template_quota
boolean
True
False
template_daily_quota
integer
Number of messages ZNS can send in 1 day
template_quality
string
unknown
: Unknown
UNDEFINED
: OA quality level not determined (in case OA does not send any ZNS notification within the assessment time frame) LOW
: Poor quality level
MEDIUM
: Medium quality level HIGH
: High quality level
template_remaining_quota
integer
Number of messages ZNS can send remaining in 1 day
template_status
string
Message status unknown
: Unknown PENDING_REVIEW
: In progress
DISABLE
: Locked
ENABLE
: Approved REJECT
: Rejected
template_tag
string
Message level unknown
: Unknown
OTP
: Tin OTP (member 0)
IN_TRANSACTION
: Confirm/Update transaction information (Tag 1)
POST_TRANSACTION
: Support related services after transaction (Tag 2)
ACCOUNT_UPDATE
: Update account information (Tag 3)
GENERAL_UPDATE
: Change service information (Tag 4)
FOLLOW_UP
: Promotional announcement to old customers (Tag 5)
template_params
array object
List of record attributes
updated_at
string<date-time>
Update time
created_at
string<date-time>
Creation time
Last updated