Sent LogoSent API Docs

Get all templates for authenticated customer with enhanced metadata and filtering

Retrieves all message templates available for the authenticated customer with comprehensive template definitions including headers, body, footer, and interactive buttons. Supports advanced filtering by search term, status, and category, plus pagination. The customer ID is extracted from the authentication token.

GET
/v2/templates
x-sender-id<token>

In: header

Query Parameters

pageinteger
Formatint32
pageSizeinteger
Formatint32
search?string | null
status?string | null
category?string | null

Header Parameters

x-sender-idstring
Formatguid
x-api-keystring

Response Body

curl -X GET "https://api.sent.dm/v2/templates?page=0&pageSize=0&search=string&status=string&category=string" \  -H "x-sender-id: string" \  -H "x-api-key: string"

{
  "items": [
    {
      "id": "7ba7b820-9dad-11d1-80b4-00c04fd430c8",
      "displayName": "Welcome Message Template",
      "category": "MARKETING",
      "language": "en_US",
      "definition": {
        "header": {
          "type": "text",
          "template": "Welcome to {{0:variable}}!",
          "variables": [
            {
              "id": 1,
              "name": "companyName",
              "type": "variable",
              "props": {
                "variableType": "text",
                "sample": "SentDM",
                "url": null,
                "shortUrl": null,
                "alt": null,
                "mediaType": null
              }
            }
          ]
        },
        "body": {
          "multiChannel": {
            "type": null,
            "template": "Hello {{1:variable}}, thank you for joining our service. We're excited to help you with your messaging needs!",
            "variables": [
              {
                "id": 1,
                "name": "customerName",
                "type": "variable",
                "props": {
                  "variableType": "text",
                  "sample": "John Doe",
                  "url": null,
                  "shortUrl": null,
                  "alt": null,
                  "mediaType": null
                }
              }
            ]
          },
          "sms": null,
          "whatsapp": null
        },
        "footer": {
          "type": "text",
          "template": "Best regards, The SentDM Team",
          "variables": null
        },
        "buttons": null,
        "definitionVersion": "1.0"
      },
      "status": "APPROVED",
      "isPublished": true,
      "whatsappTemplateId": "123456789",
      "whatsappTemplateName": "welcome_message_v1",
      "createdAt": "2024-01-15T10:30:00+00:00",
      "updatedAt": "2024-01-16T14:22:00+00:00"
    }
  ],
  "totalCount": 1,
  "page": 0,
  "pageSize": 50,
  "totalPages": 1
}
Empty
Empty