List all templates

get

https://{youraccountname}.api-us1.com/api/3/templates

Retrieve the email templates in the account. Results are paginated and can be filtered; meta.total holds the total number of templates matching the request. Responses include each template's full HTML by default and are large as a result; pass exclude=content,preview_content whenever the body is not needed.

Query Params

limit

int32

Defaults to 20

The number of templates to return for each call. Maximum value is 100.

offset

int32

Defaults to 0

Offset index of records to return.

filters[name]

string

Filter by template name. Matches any template whose name contains this value.

filters[id]

int32

Filter by template id.

filters[categoryid]

int32

Filter by template category id.

filters[source]

int32

Filter by the source the template was created from.

filters[read_only]

int32

Filter by read-only templates. Use 1 for read-only templates, 0 for editable ones.

filters[mdate]

string

Filter by the date the template was last modified (YYYY-MM-DD).

filters[hidden]

int32

Filter by hidden templates. Use 1 for hidden templates, 0 for visible ones.

filters[ed_version]

int32

Filter by the designer version the template was built with.

filters[has_content]

string

Set to true to only return templates that have content.

filters[tagid]

int32

Filter to templates carrying the given tag id.

exclude

string

Comma-separated list of response fields to omit. Use exclude=content,preview_content unless the caller needs the template's HTML body: those two fields carry the whole email and dominate the response. On a five-template account the full response is roughly 512 KB, of which about 123 KB per record is content and about 60 KB is preview_content; omitting both returns the same ids, names, URLs and timestamps in roughly 2.6 KB. Listing, searching, counting and identifying templates need none of the omitted fields. Not supported on GET /templates/{id}, which always returns the full record.

Response

200200