Skip to main content

List Templates

Retrieve a paginated list of the templates on your account.

Request​

GET /templates

Query Parameters​

ParameterTypeDefaultDescription
pageinteger1Page number (min: 1)
per_pageinteger100Items per page (min: 1, max: 100)
searchstring—Partial, case-insensitive match on the template name (max 255 characters)
sortstring-created_atSort 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.

FieldTypeDescription
uuidstringUnique identifier for the template. Use it as a campaign's template_uuid.
namestringTemplate name
subjectstring|nullEmail subject line. null until set.
created_atstringISO 8601 timestamp (UTC)
updated_atstringISO 8601 timestamp (UTC) the template last changed

Pagination Object​

FieldTypeDescription
current_pageintegerCurrent page number
per_pageintegerNumber of items per page
totalintegerTotal 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."]
}
}
}