# Template by ID

Retrieve the configuration settings for a specific template. To obtain a valid template_ID, first call GET /v3/REST/template to list your templates.

Endpoint: GET /v3/REST/template/{template_ID}
Version: 1.0.0
Security: basicAuth

## Path parameters:

  - `template_ID` (integer, required)
    Unique numeric ID for the template you want to retrieve.
    Example: 3000

## Response 200 fields (application/json):

  - `Count` (integer)
    Indicates the number of objects in the Data array.

  - `Data` (array)
    A JSON array containing a list of objects returned by this endpoint.

  - `Data.ID` (integer)
    Unique numeric ID for this template.

  - `Data.OwnerId` (integer)
    The UserID associated with the owner of this template.

  - `Data.Previews` (object)
    A JSON array containing Data ID's for the previews.

  - `Data.CreatedAt` (string)
    Timestamp indicating when the template was created.

  - `Data.LastUpdatedAt` (string)
    Timestamp indicating when the template was last updated.

  - `Data.Author` (string)
    The name of the template author.

  - `Data.Categories` (string)
    An array containing a list of strings indicating the categories, to which the template is associated. Accepted values are full, basic, newsletter, e-commerce, events, travel, sports, welcome, contact-property-update, support, invoice, anniversary, account, activation.

  - `Data.Copyright` (string)
    The Copyright message.

  - `Data.Description` (string)
    Free text used as a description for this template.

  - `Data.EditMode` (integer)
    Edit mode for this template:

- 1 - Passport drag-and-drop builder
- 2 - Passport HTML builder
- 3 - Passport Saved Section (snippet) builder
- 4 - Passport MJML builder

When a template is created through the API, the value has to be set by the caller - there is no fallback. Templates created in the Mailjet app are always 1 - Passport drag-and-drop builder.

  - `Data.IsStarred` (boolean)
    Indicates whether this campaign is marked as starred or not.

Default value: false

  - `Data.IsTextPartGenerationEnabled` (boolean)
    Indicates whether the generation of a text version of the template will be enabled or not.

Default value: false

  - `Data.Locale` (string)
    The locale for this template (AnsiString).

Default value: en_US

  - `Data.Name` (string)
    Internal name for this template.

  - `Data.OwnerType` (string)
    Indicates the type of the template owner.

Possible values:

- apikey - Templates and their content can be retrieved, edited and used only by the API Key they were created from.
- user - Templates created by the Primary API Key. Templates and their content can be retrieved by the Primary API Key, as well as all subaccount API Keys. However, they can be edited and used only by the Primary API Key.
- global - Generic templates created by Mailjet visible in the Passport Template Gallery.

For templates created in the Mailjet app, the value depends on the account that created them - user for the Primary API Key, apikey for a subaccount API Key.

  - `Data.Presets` (string)
    A JSON string containing the different pre-defined styles for this template.

  - `Data.Purposes` (array)
    An array indicating whether the template is a marketing, transactional or automation one. Upon POST request only the first value in the array is taken into account.

Possible values:

- marketing
- transactional
- automation

If no value is set, the template will not be visible in the Mailjet app, as there is no tab under which to display it.
    Enum: "marketing", "transactional", "automation"

  - `Total` (integer)
    Indicates the number of objects in the Data array.


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 404 fields

## Response 429 fields

## Response 500 fields
