Get Email Templates¶
GET /rest/asset/v1/emailTemplates.json
Method: GET
Path: /rest/asset/v1/emailTemplates.json
Tag: Email Templates
Operation ID: getEmailTemplatesUsingGET
Returns a list of email template records accessible in the target instance. Required Permissions: Read-Only Assets, Read-Write Assets.
Note: Email templates created with the new email designer may appear in this API's response, but some of the fields may be null or incomplete. For complete and reliable details of these assets, use the Email Templates (New) APIs; refer to the List Email Templates endpoint.
Formats¶
- Request:
application/x-www-form-urlencoded - Response:
application/json
Request¶
Query parameters¶
| Name | Type | Required | Description | Constraints |
|---|---|---|---|---|
offset |
integer (int32) | No | Integer offset for paging | |
maxReturn |
integer (int32) | No | Maximum number of records to return. Max 200, default 20 | |
status |
string | No | Status filter for draft or approved versions | enum: approved, draft |
Example request¶
GET {{base_url}}/rest/asset/v1/emailTemplates.json?offset={{offset}}&maxReturn={{maxReturn}}&status=approved
Accept: application/json
Responses¶
200 — OK¶
Schema: model: ResponseOfEmailTemplateResponse
Generated example¶
{
"errors": [
{
"code": "string",
"message": "string"
}
],
"requestId": "123",
"result": [
{
"createdAt": "2026-01-15T10:30:00Z",
"description": "string",
"folder": {
"id": 123,
"type": "Folder"
},
"id": 123,
"name": "Example name",
"status": "string",
"updatedAt": "2026-01-15T10:30:00Z",
"url": "https://example.com",
"version": 1,
"workspace": "string"
}
],
"success": true,
"warnings": [
"string"
]
}
Referenced models¶
Source¶
Generated from swagger-asset.json.
Generated examples are inferred from the schema. They are illustrative and may not be valid production payloads.