Get templates list

Retrieves a paginated list of message templates for the authenticated customer. Supports filtering by status, category, and search term.

GET
/v3/templates

Response 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-03-01T15:21:52.0621849+00:00",
        "updated_at": "2026-03-16T15:21:52.0621856+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-31T15:21:52.0622131+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/docs/reference/api/error-catalog"
  },
  "meta": {
    "request_id": "req_7X9zKp2jDw",
    "timestamp": "2026-03-31T15:21:52.0622161+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/docs/reference/api/error-catalog"
  },
  "meta": {
    "request_id": "req_7X9zKp2jDw",
    "timestamp": "2026-03-31T15:21:52.0622166+00:00",
    "version": "v3"
  }
}