curl --request POST \
--url https://cloudapi.mailercloud.com/v1/templates/list \
--header 'Authorization: <api-key>' \
--header 'Content-Type: <content-type>' \
--data '
{
"page": 1,
"limit": 50
}
'{
"data": [
{
"id": "uSZy",
"name": "Welcome Email",
"template_type": "html",
"status": "saved",
"created_date": "2026-06-01 14:32:00",
"modified_date": "2026-06-01 14:32:00"
},
{
"id": "uuaK",
"name": "Spring Promo (AMP)",
"template_type": "amp",
"status": "saved",
"created_date": "2026-05-28 09:14:00",
"modified_date": "2026-05-30 11:02:00"
}
],
"template_count": 137,
"truncated": false
}List Templates
Get a list of your saved email templates.
By default the response returns only template metadata (id, name, type, status, dates) — fast and small, ideal for building a template picker or dashboard.
If you also want the full template body (HTML, AMP, and plain text) inlined in the same response, set include_content: true. This is useful when you need to render or display the templates yourself without making a separate GET /templates/details/{id} call for each one.
You can filter, sort, search, and paginate through your templates:
- Filter by template type (
html,amp, or both) - Filter by status (
saved,draft, or both) - Filter by category
- Search by template name (case-insensitive substring match)
- Sort by name, created date, or modified date — ascending or descending
- Paginate with
pageandlimit
Response limits when include_content: true:
Because template bodies can be large, two safeguards apply when you ask for content:
limitis capped at 20 templates per response (even if you request more).- The total response size is capped at 10 MB.
If the response would exceed the size cap, you’ll receive as many templates as fit, and the response will include truncated: true. When this happens, fetch the missing templates one at a time using GET /templates/details/{id} — the template_count field tells you the total number of templates that match your filter so you know how many are missing.
curl --request POST \
--url https://cloudapi.mailercloud.com/v1/templates/list \
--header 'Authorization: <api-key>' \
--header 'Content-Type: <content-type>' \
--data '
{
"page": 1,
"limit": 50
}
'{
"data": [
{
"id": "uSZy",
"name": "Welcome Email",
"template_type": "html",
"status": "saved",
"created_date": "2026-06-01 14:32:00",
"modified_date": "2026-06-01 14:32:00"
},
{
"id": "uuaK",
"name": "Spring Promo (AMP)",
"template_type": "amp",
"status": "saved",
"created_date": "2026-05-28 09:14:00",
"modified_date": "2026-05-30 11:02:00"
}
],
"template_count": 137,
"truncated": false
}Authorizations
Body
Comma-separated filter. Allowed tokens: html, amp.
- Omitted or empty: no filter (all types).
"html": HTML templates only (matches every non-AMP row, including legacy Stripo/DnD/plugin types)."amp": AMP templates only."html,amp": both (equivalent to no filter).
Whitespace around commas is trimmed. Unknown tokens (e.g. "plaintext") return 400. Trailing comma returns 400.
When true, response rows include html, amp_content, and plain_text fields populated with the full template content. Server-side: limit is silently clamped to 20, and the total response is bounded by a 10 MB soft budget. When the budget is exceeded after the first row, remaining rows are skipped and truncated: true is set.
Response
OK