Skip to main content
GET
/
v1
/
template
Fetch Template List
curl --request GET \
  --url https://hub.suprsend.com/v1/template \
  --header 'Authorization: Bearer <token>'
{
  "meta": {
    "count": 1,
    "limit": 10,
    "offset": 0
  },
  "results": [
    {
      "id": "166277",
      "name": "Task Reminder",
      "slug": "task-reminder",
      "description": "Batched template for all pending tasks",
      "is_active": true,
      "default_language": {
        "name": "English",
        "slug": "en"
      },
      "created_at": "2023-01-25T04:53:39.237291Z",
      "updated_at": "2023-08-28T05:06:22.461443Z",
      "updated_by": {
        "name": "team_member",
        "email": "user@example.com"
      },
      "last_triggered_at": "2023-08-10T12:44:03.361158Z",
      "is_auto_translate_enabled": false,
      "enabled_languages": [
        "en",
        "fr",
        "es"
      ],
      "channels": [
        {
          "id": "<integer>",
          "channel": {
            "name": "Email",
            "slug": "email",
            "is_template_approval_needed": true
          },
          "is_active": true,
          "is_enabled": true,
          "created_at": "2023-01-25T04:53:39.268299Z",
          "updated_at": "2023-01-25T04:53:39.404273Z",
          "disabled_languages": [],
          "versions": []
        }
      ],
      "tags": [
        {
          "id": "01H9HPT1C5ABN61S12D85J9DJ7",
          "name": "tag"
        }
      ]
    }
  ]
}
Legacy API. This is the older endpoint to list templates. We have released template 2.0 with variant support due to which the content structure and template APIs have changed. The new APIs are listed under Management API → Templates.This endpoint continues to return templates created before 14 April 2026, including their live and draft content. Templates created on or after that date are only available through the new APIs.

Authorizations

​
Authorization
string
header
required

Pass as Bearer <API_KEY>. Get API Key from SuprSend dashboard Developers -> API Keys section.

Query Parameters

​
has_tag_ids_any
string

comma separated string of tag ids attached to the template

​
has_channels_any
string

comma separated string of channels. Returns templates which has any of the channels present from the channel string. Use these keys for channels - email, sms, whatsapp, inbox, slack, androidpush, iospush, webpush

​
is_active
boolean

Set true for published templates, false for templates which are in draft. Do not pass this key to return all templates.

​
is_archived
boolean

Set true to get archived templates, default = false

Response

200 - application/json

200

​
meta
object
​
results
object[]