List email templates

GET

/templates/

GET

/notification/templates/

const url = 'https://api.etera.dev/notification/templates/';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

200Retrieved

{
  "success": true,
  "data": {
    "templates": [
      {
        "id": "string",
        "name": "string",
        "subject": "string",
        "variables": [
          "string"
        ],
        "category": "string",
        "isActive": true,
        "tags": [
          "string"
        ],
        "metadata": {},
        "createdAt": "string",
        "updatedAt": "string",
        "html": "string",
        "text": "string",
        "description": "string",
        "createdBy": "string",
        "usageCount": 1.1
      }
    ],
    "pagination": {
      "page": 1.1,
      "limit": 1.1,
      "total": 1.1,
      "totalPages": 1.1,
      "hasNext": true,
      "hasPrev": true
    },
    "filters": {
      "categories": [
        "string"
      ],
      "tags": [
        "string"
      ]
    }
  },
  "error": {
    "message": "string",
    "code": "string"
  }
}

Get a paginated list of email templates with filtering and sorting options.

Query Parameters:

page: Page number (default: 1)
limit: Items per page (1-100, default: 10)
search: Search in name, description, and subject
category: Filter by template category
isActive: Filter by active status (true/false)
tags: Comma-separated list of tags to filter by
sortBy: Sort field (name, createdAt, updatedAt, category)
sortOrder: Sort direction (asc, desc)

Response:

Paginated list of templates with usage statistics
Available categories and tags for filtering
Pagination metadata for navigation

Use Cases:

Template management dashboard
Template selection for campaigns
Template library browsing
Usage analytics and reporting

Authentication

AuthorizationBearer

JWT token for authentication. Use ‘test-jwt-token’ for development.

Query parameters

pagestringOptional

limitstringOptional

searchstringOptional

categorystringOptional

isActivestringOptional

tagsstringOptional

sortBystringOptional

sortOrderstringOptional

Response

This endpoint returns an object.

successboolean

dataobjectOptional

errorobjectOptional