Audit log de envíos

GET

/v1/mail/audit

curl --request GET \
  --url 'https://api.mailerdash.com/v1/mail/audit?limit=100&offset=0&sort_by=ts&sort_dir=asc&format=json' \
  --header 'Authorization: Bearer <token>'

• Production
• Local development

Retorna los últimos N registros del audit log, del más reciente al más antiguo.

Authorizations

• BearerAuth

Parameters

Query Parameters

limit

integer

default: 100 <= 1000

offset

integer

0

app

string

Filtrar por ID de app key

client_id

string

Filtrar por cliente (admin only) — expande a las keys vinculadas del cliente

event

string

Filtrar por tipo de evento. Acepta valor único (sent) o lista CSV (sent,failed). Valores válidos: sent, failed, queued.

from

string format: date-time

Timestamp ISO desde (inclusive). Ej. 2026-05-01T00:00:00Z.

to

string format: date-time

Timestamp ISO hasta (inclusive).

search

string

Substring case-insensitive contra recipient o asunto.

sort_by

string

Allowed values: ts event subject

Columna de ordenamiento.

sort_dir

string

Allowed values: asc desc

Dirección. Default desc.

format

string

Allowed values: json csv

Formato de respuesta. csv ignora limit/offset y devuelve todo el resultado filtrado con Content-Type: text/csv.

Responses

200

Lista paginada de eventos de auditoría

Media type application/json

object

total

integer

limit

integer

offset

integer

items

Array<object>

object

Example ^generated

{
  "total": 1,
  "limit": 1,
  "offset": 1,
  "items": [
    {}
  ]
}

401

Unauthorized