Get Email Log

GET

/v1/log/{uuid}

const url = 'https://api.contacta.mx/v1/log/1b9d6e34-634a-4762-8d5a-f9cb9165d432';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.contacta.mx/v1/log/1b9d6e34-634a-4762-8d5a-f9cb9165d432 \
  --header 'Authorization: Bearer <token>'

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

Parameters

Path Parameters

uuid

required

string format: uuid

Example

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

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

Responses

200

Email log retrieved successfully

application/json

object

status

boolean

message

string

data

Array<object>

object

integer

usuario

Internal user ID

integer

campania

Internal campaign ID

integer

estatus

Raw status code

integer

fecha_envio

Date and time the email was queued for sending

string format: date-time

fecha_confirmacion

Date and time delivery was confirmed by the mail server

string format: date-time

fecha_lectura

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

string format: date-time

nullable

token_mail

UUID that uniquely identifies this email send

string format: uuid

correo

Recipient email address

string format: email

nombre

Recipient name

string

MessageID

Message ID assigned by the mail relay

string

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

user

object

username

string

name

string

campaign

object

descripcion

string

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

application/json

object

status

boolean

message

string

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

application/json

object

status

boolean

message

string

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
  }
}