{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/content-api/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"List of Templates","siteUrl":"https://dev.mailjet.com/","projectTitle":"Mailjet Developer Documentation","description":"List email templates via GET /v1/REST/templates. Filter by Name, EditMode, Purposes, LabelIDs, or ExternalID needed for sending in the Mailjet Content API.","image":"https://dev.mailjet.com/og-image.png","lang":"en-US","keywords":["Mailjet API","Email API","Content API","SMTP Relay","transactional email","email delivery","Send API","email templates","developer documentation"],"meta":[{"name":"og:type","content":"website"},{"name":"og:site_name","content":"Mailjet Developer Documentation"},{"name":"twitter:card","content":"summary_large_image"},{"name":"robots","content":"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1"},{"name":"googlebot","content":"index, follow, max-snippet:-1, max-image-preview:large"}],"jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://dev.mailjet.com/#organization","name":"Mailjet","alternateName":"Sinch Mailjet","url":"https://www.mailjet.com","logo":"https://assets.mailjet.com/lib/images/mailjetLogo/mj_logo_with_text_color.png","parentOrganization":{"@type":"Organization","name":"Sinch","url":"https://www.sinch.com"}},{"@type":"WebSite","@id":"https://dev.mailjet.com/#website","name":"Mailjet Developer Documentation","description":"Official developer documentation for the Mailjet Email API, Content API and SMTP Relay.","url":"https://dev.mailjet.com/","inLanguage":"en-US","publisher":{"@id":"https://dev.mailjet.com/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://dev.mailjet.com/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]},"llmstxt":{"hide":false,"title":"Mailjet Developer Documentation","description":"Developer documentation for the Mailjet Email API, Content API and SMTP Relay - guides, API references and code samples for sending, templating and tracking email at scale.","details":{"content":"Mailjet (part of Sinch) provides APIs for sending and managing email.\n\nThis documentation covers four main areas:\n\n- **Email API** - the Send API (v3 and v3.1) for transactional and marketing email,\n  plus contact management, segmentation, campaigns, statistics, webhooks, the Parse API\n  and the Mailjet Templating Language.\n- **Content API** - programmatic management of email templates, template contents,\n  images, labels and authentication tokens (v1).\n- **SMTP Relay** - sending through Mailjet's SMTP servers, including custom headers.\n- **API Reference** - the complete, generated reference for every endpoint, built directly\n  from the OpenAPI specifications.\n\nBase URL for all REST APIs: `https://api.mailjet.com`.\nAuthentication uses HTTP Basic auth with an API key and secret key.\n\n## Machine-readable entry points\n\nPrefer these when you need the API surface in as few requests as possible:\n\n- `/openapi/openapi-mailjet.md` - the **complete** Email API reference (every endpoint,\n  grouped by resource) as a single Markdown document.\n- `/openapi/openapi-passport.md` - the **complete** Content API reference as a single\n  Markdown document.\n- `/_bundle/openapi/openapi-mailjet.yaml` - the raw, fully bundled OpenAPI 3 description\n  of the Email API.\n- `/_bundle/openapi/openapi-passport.yaml` - the raw, fully bundled OpenAPI 3 description\n  of the Content API.\n- `/sitemap.xml` - every indexable URL on this site.\n\nEvery page on this site is also available as clean Markdown by appending `.md` to its URL."},"sections":[{"title":"Email API","description":"Sending, contacts, campaigns, statistics, webhooks and templating.","includeFiles":["docs/email-api/**/*.md"],"excludeFiles":[]},{"title":"Content API","description":"Manage templates, template contents, images, labels and tokens.","includeFiles":["docs/content-api/**/*.md","docs/content-api.md"],"excludeFiles":[]},{"title":"SMTP Relay","description":"Send email through Mailjet's SMTP servers.","includeFiles":["docs/smtp-relay/**/*.md"],"excludeFiles":[]},{"title":"API Reference","description":"Complete generated reference for every Mailjet API endpoint.","includeFiles":["openapi/openapi-mailjet.yaml","openapi/openapi-passport.yaml","docs/api-reference/**/*.md"],"excludeFiles":[]},{"title":"Migrating from Mandrill","description":"Guides for switching from Mandrill to Mailjet.","includeFiles":["docs/mandrill/**/*.md"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"list-of-templates","__idx":0},"children":["List of Templates"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["Endpoint"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET https://api.mailjet.com/v1/REST/templates"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Using this endpoint, you can retrieve comprehensive list of templates and their corresponding data, including the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ExternalID"]}," which is needed to send your templates."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"query-parameters","__idx":1},"children":["Query Parameters"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Name"},"children":["Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sort"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sort is available for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CreatedAt"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsStarred"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UpdatedAt"]},". ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":["Default"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ID ASC"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CheckLocaleOnLastContent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["True"]}," = check the value of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Locale"]}," query parameter based on the last content"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search by the ID of the template."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IDs"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of integers"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search by multiple template IDs."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search by the template name. Only returns exact match."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PartialName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search by partial or fragmentary name."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Locale"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search by the template locale. See the list of accepted locales."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EditMode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accepted values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["4"]},". See more about Edit mode."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LabelIDs"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of integers"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search by label IDs associated to a template."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Purposes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Comma-separated list of purposes. Filters templates having all specified purposes. Accepted values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["marketing"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactional"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["opt-in"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["automation"]},". Learn more about template purposes."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ExternalID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search by the send ID of the template."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsPublished"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["True"]}," = published"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsStarred"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["True"]}," = favorite"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request","__idx":2},"children":["Example Request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"curl --request GET \\\n  --url https://api.mailjet.com/v1/rest/templates?Limit=3&Sort=UpdatedAt%20DESC&IsStarred=false&Purposes=marketing' / \\\n  --header 'Authorization: Bearer 612d5125131d406081abb9cd2afdc4e3'\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["Status Code"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-data-field-structure","__idx":3},"children":["Response Data Field Structure:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Name"},"children":["Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ID of the template."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The name of the template."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EditMode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the mode in which the template can be edited."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LabelIDs"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of integers"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An array of IDs representing labels associated with the template."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Purposes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of strings"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The type of template. Learn more about template purposes."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ExternalID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string or null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ID that must be used to send the template."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string or null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A brief description of the template."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsPublished"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indicates whether the template is published."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsStarred"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indicates whether the template is marked as a favorite."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsTextPartGenerationEnabled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Determines if text part generation functionality is enabled for this template."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CreatedAt"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Date RFC3339"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The date and time when the template was created."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UpdatedAt"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Date RFC3339"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The date and time when the template was last updated."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"api-reponse-example","__idx":4},"children":["API Reponse Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n\t\"Count\": 3,\n\t\"Total\": 6,\n\t\"Data\": [\n\t\t{\n\t\t\t\"ID\": 12,\n\t\t\t\"OrganisationID\": 2,\n\t\t\t\"Name\": \"Welcome to Mailjet1\",\n\t\t\t\"EditMode\": 2,\n\t\t\t\"LabelIDs\": [],\n\t\t\t\"LastContentType\": null,\n\t\t\t\"PartialIDs\": [],\n\t\t\t\"Purposes\": [\n\t\t\t\t\"marketing\",\n\t\t\t\t\"transactional\"\n\t\t\t],\n\t\t\t\"Categories\": [\n\t\t\t\t\"e-commerce\"\n\t\t\t],\n\t\t\t\"Presets\": null,\n\t\t\t\"ExternalID\": \"123\",\n\t\t\t\"Description\": null,\n\t\t\t\"IsPublished\": false,\n\t\t\t\"IsStarred\": false,\n\t\t\t\"SoftDeleted\": false,\n\t\t\t\"IsTextPartGenerationEnabled\": false,\n\t\t\t\"CreatedAt\": \"2024-04-19T11:44:24.0638Z\",\n\t\t\t\"UpdatedAt\": \"2024-04-19T11:44:24.0638Z\"\n\t\t},\n\t\t{\n\t\t\t\"ID\": 11,\n\t\t\t\"OrganisationID\": 2,\n\t\t\t\"Name\": \"Welcome to Mailjet2\",\n\t\t\t\"EditMode\": 2,\n\t\t\t\"LabelIDs\": [],\n\t\t\t\"LastContentType\": null,\n\t\t\t\"PartialIDs\": [],\n\t\t\t\"Purposes\": [\n\t\t\t\t\"marketing\",\n\t\t\t\t\"transactional\"\n\t\t\t],\n\t\t\t\"Categories\": null,\n\t\t\t\"Presets\": null,\n\t\t\t\"ExternalID\": \"456\",\n\t\t\t\"Description\": null,\n\t\t\t\"IsPublished\": false,\n\t\t\t\"IsStarred\": false,\n\t\t\t\"SoftDeleted\": false,\n\t\t\t\"IsTextPartGenerationEnabled\": false,\n\t\t\t\"CreatedAt\": \"2024-04-19T11:43:56.283337Z\",\n\t\t\t\"UpdatedAt\": \"2024-04-19T11:43:56.283337Z\"\n\t\t},\n\t\t{\n\t\t\t\"ID\": 10,\n\t\t\t\"OrganisationID\": 2,\n\t\t\t\"Name\": \"Welcome to Mailjet3\",\n\t\t\t\"EditMode\": 2,\n\t\t\t\"LabelIDs\": [],\n\t\t\t\"LastContentType\": null,\n\t\t\t\"PartialIDs\": [],\n\t\t\t\"Purposes\": [\n\t\t\t\t\"marketing\",\n\t\t\t\t\"transactional\"\n\t\t\t],\n\t\t\t\"Categories\": null,\n\t\t\t\"Presets\": null,\n\t\t\t\"ExternalID\": \"789\",\n\t\t\t\"Description\": null,\n\t\t\t\"IsPublished\": false,\n\t\t\t\"IsStarred\": false,\n\t\t\t\"SoftDeleted\": false,\n\t\t\t\"IsTextPartGenerationEnabled\": false,\n\t\t\t\"CreatedAt\": \"2024-04-19T11:33:57.789254Z\",\n\t\t\t\"UpdatedAt\": \"2024-04-19T11:33:57.789254Z\"\n\t\t}\n\t]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"retrieve-a-single-template","__idx":5},"children":["Retrieve a Single Template"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["Endpoint"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET https://api.mailjet.com/v1/REST/templates/:id"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Using this endpoint, you can retrieve detailed information about a specific email template using its unique template ID. This endpoint is particularly useful when you need to fetch the details of a single template for viewing, editing, or sending purposes."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"url-parameters","__idx":6},"children":["URL Parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," = The ID of the template."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request-1","__idx":7},"children":["Example Request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"curl --request GET \\\n  --url https://api.mailjet.com/v1/rest/templates/1 \\\n  --header 'Authorization: Bearer 612d5125131d406081abb9cd2afdc4e3'\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["Status code:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-data-field-structure-1","__idx":8},"children":["Response Data Field Structure:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Name"},"children":["Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ID of the template."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The name of the template."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EditMode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the mode in which the template can be edited."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LabelIDs"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of integers"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An array of IDs representing labels associated with the template."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Purposes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of strings"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The type of template. Learn more about template purposes."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ExternalID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string or null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ID that must be used to send the template."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string or null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A brief description of the template."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsPublished"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indicates whether the template is published."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsStarred"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indicates whether the template is marked as a favorite."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsTextPartGenerationEnabled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Determines if text part generation functionality is enabled for this template."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CreatedAt"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Date RFC3339"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The date and time when the template was created."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UpdatedAt"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Date RFC3339"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The date and time when the template was last updated."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"api-response-example","__idx":9},"children":["API Response Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n    \"Count\": 1,\n    \"Total\": 1,\n    \"Data\": [\n        {\n            \"ID\": 27,\n            \"OrganisationID\": 2,\n            \"Name\": \"Welcome to Mailjet!\",\n            \"EditMode\": 2,\n            \"LabelIDs\": [],\n            \"LastContentType\": null,\n            \"PartialIDs\": [],\n            \"Purposes\": [\n                \"marketing\",\n                \"transactional\"\n            ],\n            \"Categories\": [\n                \"e-commerce\"\n            ],\n            \"Presets\": null,\n            \"ExternalID\": \"123\",\n            \"Description\": null,\n            \"IsPublished\": false,\n            \"IsStarred\": true,\n            \"SoftDeleted\": false,\n            \"IsTextPartGenerationEnabled\": false,\n            \"CreatedAt\": \"2024-05-23T09:05:22.21546Z\",\n            \"UpdatedAt\": \"2024-05-23T09:05:22.21546Z\"\n        }\n    ]\n}\n"},"children":[]}]},"headings":[{"value":"List of Templates","id":"list-of-templates","depth":1},{"value":"Query Parameters","id":"query-parameters","depth":2},{"value":"Example Request","id":"example-request","depth":3},{"value":"Response Data Field Structure:","id":"response-data-field-structure","depth":2},{"value":"API Reponse Example","id":"api-reponse-example","depth":3},{"value":"Retrieve a Single Template","id":"retrieve-a-single-template","depth":2},{"value":"URL Parameters","id":"url-parameters","depth":4},{"value":"Example Request","id":"example-request-1","depth":3},{"value":"Response Data Field Structure:","id":"response-data-field-structure-1","depth":3},{"value":"API Response Example","id":"api-response-example","depth":3}],"frontmatter":{"title":"Mailjet Content API","seo":{"description":"List email templates via GET /v1/REST/templates. Filter by Name, EditMode, Purposes, LabelIDs, or ExternalID needed for sending in the Mailjet Content API.","title":"List of Templates"}},"lastModified":"2026-08-26T10:53:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/content-api/email-templates/list-templates","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}