Skip to main content
GET
/
api
/
templates
/
email
List All Transactionals
curl --request GET \
  --url https://app.minimo.it/api/templates/email \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 123,
      "name": "<string>",
      "created": "2023-11-07T05:31:56Z",
      "updated": "2023-11-07T05:31:56Z"
    }
  ]
}

Overview

Get a list of all email templates you’ve created in the Minimo dashboard. Use this endpoint to:
  • Display available templates in your application
  • Verify template IDs before sending emails
  • Build template selection interfaces
  • Audit your template library

Response Structure

The response includes template metadata:
{
  "data": [
    {
      "id": "tmpl_abc123",
      "name": "Order Confirmation",
      "subject": "Your order {{orderNumber}} is confirmed",
      "status": "active",
      "category": "transactional",
      "createdAt": "2025-10-01T10:00:00Z",
      "updatedAt": "2025-11-01T15:30:00Z",
      "variables": ["orderNumber", "customerName", "total"]
    },
    {
      "id": "tmpl_xyz789",
      "name": "Welcome Email",
      "subject": "Welcome to {{companyName}}!",
      "status": "active",
      "category": "marketing",
      "createdAt": "2025-09-15T09:00:00Z",
      "updatedAt": "2025-09-15T09:00:00Z",
      "variables": ["companyName", "firstName"]
    }
  ]
}

Template Categories

Templates can belong to different categories:
CategoryDescriptionExamples
transactionalOrder-related, account notificationsOrder confirmation, password reset
marketingPromotional campaignsProduct launch, newsletter
automatedTriggered by user behaviorWelcome series, abandoned cart

Template Status

StatusDescription
activeTemplate is ready to use
draftTemplate is being edited
archivedTemplate is no longer in use
Only active templates can be used with the Send Email Template endpoint.

Use Cases

Template Selector UI

Build a dropdown to let users choose templates:
async function loadTemplates() {
  const response = await fetch('https://app.minimo.it/api/templates/email', {
    headers: {
      Authorization: `Bearer ${apiKey}`,
    },
  });

  const { data: templates } = await response.json();

  // Filter only active templates
  const activeTemplates = templates.filter((t) => t.status === 'active');

  // Populate dropdown
  const select = document.getElementById('template-select');
  activeTemplates.forEach((template) => {
    const option = document.createElement('option');
    option.value = template.id;
    option.textContent = template.name;
    select.appendChild(option);
  });
}

Validate Template ID

Before sending an email, verify the template exists:
async function isValidTemplate(templateId) {
  const response = await fetch('https://app.minimo.it/api/templates/email', {
    headers: {
      Authorization: `Bearer ${apiKey}`,
    },
  });

  const { data: templates } = await response.json();

  return templates.some((t) => t.id === templateId && t.status === 'active');
}

Filtering (Coming Soon)

Future versions will support filtering:
GET /api/templates/email?category=transactional&status=active

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Successful response with a list of transactional messages.

data
object[]