Get templates list
Retrieves a paginated list of message templates for the authenticated customer. Supports filtering by status, category, and search term.
Query Parameters
page*integer
Page number (1-indexed)
Format
int32page_size*integer
Number of items per page
Format
int32search?|
Optional search term for filtering templates
status?|
Optional status filter: APPROVED, PENDING, REJECTED
category?|
Optional category filter: MARKETING, UTILITY, AUTHENTICATION
is_welcome_playground?|
Optional filter by welcome playground flag
Header Parameters
x-profile-id?string
Profile UUID to scope the request to a child profile. Only organization API keys can use this header. The profile must belong to the calling organization.
Format
uuidResponse Body
application/json
application/json
application/json
curl -X GET "https://api.sent.dm/v3/templates?page=1&page_size=20&search=welcome&status=APPROVED"{
"success": true,
"data": {
"templates": [
{
"id": "7ba7b820-9dad-11d1-80b4-00c04fd430c8",
"name": "Welcome Message",
"category": "MARKETING",
"language": "en_US",
"status": "APPROVED",
"channels": [
"sms",
"whatsapp"
],
"variables": [
"name",
"company"
],
"created_at": "2026-02-09T21:50:49.8560565+00:00",
"updated_at": "2026-02-24T21:50:49.8560576+00:00",
"is_published": true
}
],
"pagination": {
"page": 1,
"page_size": 20,
"total_count": 1,
"total_pages": 1,
"has_more": false,
"cursors": null
}
},
"error": null,
"meta": {
"request_id": "req_7X9zKp2jDw",
"timestamp": "2026-03-11T21:50:49.8562221+00:00",
"version": "v3"
}
}{
"success": false,
"data": null,
"error": {
"code": "VALIDATION_001",
"message": "Request validation failed",
"details": {
"page_size": [
"Page size must be between 1 and 100"
]
},
"doc_url": "https://docs.sent.dm/errors/VALIDATION_001"
},
"meta": {
"request_id": "req_7X9zKp2jDw",
"timestamp": "2026-03-11T21:50:49.8562289+00:00",
"version": "v3"
}
}Empty
Empty
{
"success": false,
"data": null,
"error": {
"code": "INTERNAL_001",
"message": "An unexpected error occurred while retrieving templates",
"details": null,
"doc_url": "https://docs.sent.dm/errors/INTERNAL_001"
},
"meta": {
"request_id": "req_7X9zKp2jDw",
"timestamp": "2026-03-11T21:50:49.8562296+00:00",
"version": "v3"
}
}