Get Email Templates

Caution

For security reasons, please contact your Account Manager to provide you with an API host.

The host https://api.example.com not is a real endpoint.

GET

/v1/templates

• Production

Retrieves the list of email templates available in your account.

Authorizations

BearerAuth

Use HTTP Bearer Authentication to authorize requests.

Provide your API token as a Bearer token in the Authorization header.

Example: Authorization: Bearer YOUR_API_TOKEN_HERE

(Replace “YOUR_API_TOKEN_HERE” with your actual API token.)

Responses

200

Email templates retrieved successfully

Array<object>

object

template_id

The unique identifier of the template

string

template123

name

The name of the template

string

Welcome Email

subject

The subject line of the template

string

Welcome to Our Service

from_name

The sender display name

string

John Doe

from_email

The sender email address

string format: email

john@doe.com

status

Whether the template is active

boolean

true

Example

[
  {
    "template_id": "template123",
    "name": "Welcome Email",
    "subject": "Welcome to Our Service",
    "from_name": "John Doe",
    "from_email": "john@doe.com",
    "status": true
  }
]

401

Unauthorized — invalid or missing API token

object

status

boolean

message

string

An http error occurred. If error persists, contact soporte@contacta.mx

data

object

message

string

code

integer

Example

{
  "status": false,
  "message": "An http error occurred. If error persists, contact soporte@contacta.mx",
  "data": {
    "message": "Your key auth is not valid, please check with your administrator",
    "code": 401
  }
}

Examples

Useful for guiding users to view code examples in different developer languages.

Bash

developer@developer:~#

curl -X GET "https://api.example.com/v1/templates" \
    -H "Accept: application/json" \
  -H "Connection: keep-alive" \
  -H "Authorization: Bearer <your-token>"

Node.js

example.js

  const fetch = require('node-fetch');

  fetch("https://api.example.com/v1/templates", {
    method: "GET",
    headers: {
  "Accept": "application/json",
  "Connection": "keep-alive",
  "Authorization": "Bearer <your-token>"
}
  })
    .then(res => res.json())
    .then(console.log)
    .catch(console.error);

PHP

example.php

  <?php
  $curl = curl_init();

  curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.example.com/v1/templates",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Connection: keep-alive",
    "Authorization: Bearer <your-token>"
    ]
  ]);

  $response = curl_exec($curl);
  curl_close($curl);
  echo $response;
  ?>

C-Sharp

example.cs

  using System.Net.Http;
  using System.Text;
  using System.Threading.Tasks;

  var client = new HttpClient();
  var request = new HttpRequestMessage(HttpMethod.GET, "https://api.example.com/v1/templates");
  request.Headers.Add("Accept", "application/json");
request.Headers.Add("Connection", "keep-alive");
request.Headers.Add("Authorization", "Bearer <your-token>");
  var response = await client.SendAsync(request);
  var responseBody = await response.Content.ReadAsStringAsync();
  Console.WriteLine(responseBody);

Python

example.py

  import requests
  import json

  url = "https://api.example.com/v1/templates"
  headers = {
    "Accept": "application/json",
  "Connection": "keep-alive",
  "Authorization": "Bearer <your-token>"
  }

  response = requests.get(url, headers=headers)
  print(response.text)

Java

example.java

  import java.io.OutputStream;
  import java.net.HttpURLConnection;
  import java.net.URL;
  import java.nio.charset.StandardCharsets;

  public class ApiExample {
    public static void main(String[] args) throws Exception {
      URL url = new URL("https://api.example.com/v1/templates");
      HttpURLConnection conn = (HttpURLConnection) url.openConnection();
      conn.setRequestMethod("GET");

      conn.setRequestProperty("Accept", "application/json");
    conn.setRequestProperty("Connection", "keep-alive");
    conn.setRequestProperty("Authorization", "Bearer <your-token>");

      int code = conn.getResponseCode();
      System.out.println("Response code: " + code);
    }
  }