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[]