Get Email Log

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/log/{uuid}

• Production

Retrieves the delivery log for a previously sent email by its UUID.

The UUID is returned in the data array when the email is queued via POST /v1/send/email or POST /v1/send/template.

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.)

Parameters

Path Parameters

uuid

required

string format: uuid

1b9d6e34-634a-4762-8d5a-f9cb9165d432

UUID of the queued email, as returned by the send endpoints

Responses

200

Email log retrieved successfully

object

status

boolean

true

message

string

Succesfully export log email

data

Array<object>

object

id

integer

1133602294

usuario

Internal user ID

integer

1

campania

Internal campaign ID

integer

121535

estatus

Raw status code

integer

2

fecha_envio

Date and time the email was queued for sending

string format: date-time

2026-06-24 17:09:54

fecha_confirmacion

Date and time delivery was confirmed by the mail server

string format: date-time

2026-06-24 17:09:55

fecha_lectura

Date and time the email was opened (null if not yet opened)

string format: date-time

nullable

2026-06-24 17:10:13

token_mail

UUID that uniquely identifies this email send

string format: uuid

1b9d6e34-634a-4762-8d5a-f9cb9165d432

correo

Recipient email address

string format: email

vmartinezrmzz@gmail.com

nombre

Recipient name

string

name

MessageID

Message ID assigned by the mail relay

string

Yk-ol0b4T3avXNaiWrsntA

credito

number

nullable

saldo_uno

number

nullable

saldo_dos

number

nullable

mora

number

nullable

comodin_a

Custom variable A

string

nullable

comodin_b

Custom variable B

string

nullable

comodin_c

Custom variable C

string

nullable

comodin_d

Custom variable D

string

nullable

status

object

descripcion

Human-readable delivery status

string

OK - OPENED EMAIL

user

object

username

string

demo

name

string

DEMO Account

campaign

object

descripcion

string

template-gateway-v1

Example

{
  "status": true,
  "message": "Succesfully export log email",
  "data": [
    {
      "id": 1133602294,
      "usuario": 1,
      "campania": 121535,
      "estatus": 2,
      "fecha_envio": "2026-06-24 17:09:54",
      "fecha_confirmacion": "2026-06-24 17:09:55",
      "fecha_lectura": "2026-06-24 17:10:13",
      "token_mail": "1b9d6e34-634a-4762-8d5a-f9cb9165d432",
      "correo": "jane@smith.com",
      "nombre": "name",
      "MessageID": "Yk-ol0b4T3avXNaiWrsntA",
      "credito": null,
      "saldo_uno": null,
      "saldo_dos": null,
      "mora": null,
      "comodin_a": null,
      "comodin_b": null,
      "comodin_c": null,
      "comodin_d": null,
      "status": {
        "descripcion": "OK - OPENED EMAIL"
      },
      "user": {
        "username": "demo",
        "name": "DEMO Account"
      },
      "campaign": {
        "descripcion": "template-gateway-v1"
      }
    }
  ]
}

400

Bad request or missing required parameters

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": "Missing required parameters, please verify your request",
    "code": 400
  }
}

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/log/{uuid}" \
    -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/log/{uuid}", {
    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/log/{uuid}",
    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/log/{uuid}");
  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/log/{uuid}"
  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/log/{uuid}");
      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);
    }
  }