List Templates
Retrieve a paginated list of the templates on your account.
Request
GET /templates
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
page | integer | 1 | Page number (min: 1) |
per_page | integer | 100 | Items per page (min: 1, max: 100) |
search | string | — | Partial, case-insensitive match on the template name (max 255 characters) |
sort | string | -created_at | Sort order: created_at, updated_at, or name. Prefix with - for descending. |
Ordering: Results default to created_at descending (newest first) unless sort is supplied.
Example Request
curl -X GET "https://email.easy.tools/api/v1/templates?page=1&per_page=50&sort=-created_at" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json"
Response
Success Response (200)
{
"data": [
{
"uuid": "94c6cd70-6747-4f1d-8cbc-b83150f33bb7",
"name": "Welcome",
"subject": "Welcome aboard",
"created_at": "2026-05-12T09:15:00Z",
"updated_at": "2026-05-20T16:42:08Z"
},
{
"uuid": "7abadab3-6ae1-45ee-b5ec-794c2efe6d7d",
"name": "Post-purchase follow-up",
"subject": null,
"created_at": "2026-04-02T11:30:00Z",
"updated_at": "2026-04-02T11:30:00Z"
}
],
"pagination": {
"current_page": 1,
"per_page": 50,
"total": 2
}
}
Response Fields
List items include only the fields below. Get Template returns the full Template Object.
| Field | Type | Description |
|---|---|---|
uuid | string | Unique identifier for the template. Use it as a campaign's template_uuid. |
name | string | Template name |
subject | string|null | Email subject line. null until set. |
created_at | string | ISO 8601 timestamp (UTC) |
updated_at | string | ISO 8601 timestamp (UTC) the template last changed |
Pagination Object
| Field | Type | Description |
|---|---|---|
current_page | integer | Current page number |
per_page | integer | Number of items per page |
total | integer | Total number of templates |
Error Responses
Validation Error (422 Unprocessable Entity)
Returned when page or per_page is out of range, search is longer than 255 characters, or sort is not a supported value.
{
"error": {
"code": "VALIDATION_ERROR",
"message": "The given data was invalid",
"details": {
"per_page": ["The per page field must not be greater than 100."]
}
}
}