Get the list of email templates

GET

https://api.brevo.com/v3/smtp/templates

GET

/v3/smtp/templates

import { BrevoClient } from "@getbrevo/brevo";
async function main() {
    const client = new BrevoClient({
        apiKey: "YOUR_API_KEY_HERE",
    });
    await client.transactionalEmails.getSmtpTemplates({});
}
main();

{
  "count": 2,
  "templates": [
    {
      "createdAt": "2016-02-24T14:44:24Z",
      "htmlContent": "HTML CONTENT 1",
      "id": 5,
      "isActive": false,
      "modifiedAt": "2016-02-24T15:37:11Z",
      "name": "ChristomasTimeTemplate",
      "replyTo": "replyto@domain.com",
      "sender": {
        "email": "john.smith@example.com",
        "id": "23",
        "name": "John"
      },
      "subject": "Merry Christmas",
      "tag": "Festival",
      "testSent": false,
      "toField": ""
    },
    {
      "createdAt": "2016-02-25T11:53:26Z",
      "htmlContent": "HTML CONTENT 2",
      "id": 12,
      "isActive": true,
      "modifiedAt": "2016-02-25T11:53:26Z",
      "name": "SummerSales2017Template",
      "replyTo": "replyto@domain.com",
      "sender": {
        "email": "john.smith@example.com",
        "id": "23",
        "name": "John"
      },
      "subject": "Enjoy our summer Sales !",
      "tag": "Summer",
      "testSent": false,
      "toField": ""
    }
  ]
}

Retrieve a paginated list of all transactional email templates (including automation templates) with their details such as name, subject, sender, status, HTML content, and timestamps. Results default to 50 per page (max 1000) and are sorted in descending creation order unless overridden. You can filter by active/inactive status using templateStatus and by editor type using editorType (currently only richTextEditor is supported).

Retrieve a paginated list of all transactional email templates (including automation templates) with their details such as name, subject, sender, status, HTML content, and timestamps. Results default to 50 per page (max 1000) and are sorted in descending creation order unless overridden. You can filter by active/inactive status using `templateStatus` and by editor type using `editorType` (currently only `richTextEditor` is supported).

Authentication

api-keystring

The API key should be passed in the request headers as api-key for authentication.

Query parameters

templateStatusbooleanOptional

Filter on the status of the template. Active = true, inactive = false

limitlongOptional0-1000Defaults to 50

Number of documents returned per page

offsetlongOptionalDefaults to 0

Index of the first document in the page

sortenumOptionalDefaults to desc

Sort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed

Allowed values:

editorTypeenumOptional

Filter on the editor type used to create the template. Currently only richTextEditor is supported as a filter value.

Allowed values:

Response

transactional email templates informations

countlongOptional

Count of transactional email templates

templateslist of objectsOptional

Errors

400

Bad Request Error