Ir al contenido

Metricas agregadas del servidor

GET
/v1/mail/stats
curl --request GET \
--url 'https://api.mailerdash.com/v1/mail/stats?hours=24' \
--header 'Authorization: Bearer <token>'
hours
integer
default: 24 <= 720
key_id
string

Solo admin — filtra stats por key_id de cliente (v0.8.3 scoping per-tenant)

Metricas del periodo

Media type application/json
object
period_hours

Ventana consultada en horas

integer
since

ISO 8601 inicio del periodo

string format: date-time
emails
object
total
integer
sent
integer
failed
integer
failure_rate
string
by_app

Desglose por key_id — objeto dinámico con claves = key_id

object
key
additional properties
object
sent
integer
failed
integer
bounces
object
total
integer
top_domains
Array<object>
object
domain
string
count
integer
recent_failures

Últimos 5 envíos fallidos del periodo

Array<object>
object
ts
string
app
string
event
string
from_email
string
to_json
string
subject
string
payload
string
recent_bounces

Últimos 5 bounces del periodo (orden cronológico inverso)

Array<object>
object
Example
{
"emails": {
"failure_rate": "2.1%"
}
}

Unauthorized