Resumen de estadísticas
GET
/v1/stats/overviewPara desarrolladores
Descripción
Devuelve, para un rango de fechas, las tasas de entrega, descarte, rebote, apertura, clic y desuscripción de sus correos, y la demora con que se entregaron.
Guía relacionada
- Reportes y estadísticas — Lea las métricas de entregabilidad de su cuenta.
Autenticación
Authorizationbearer tokenheaderobligatorio- API key con scope
stats:read. Formato:Bearer <API_KEY>. X-Instance-Slugstringheaderobligatorio- Identificador de su instancia. Ver Autenticación.
Request
Query params:
start_datestring (date, `YYYY-MM-DD`) | null- Fecha local de inicio. Si se omite, se usan los 3 meses previos a
end_date. end_datestring (date, `YYYY-MM-DD`) | null- Fecha local de fin. Si se omite, se usa el día de hoy.
tzstring (zona IANA) | null- Zona para interpretar las fechas. Sin valor: zona de la instancia, o UTC.
send_typesarray de string, enum: `transactional | bulk | test_sandbox`- Tipos de envío a incluir. Para incluir varios, repita el parámetro:
?send_types=transactional&send_types=bulk. Cada correo pertenece a uno solo:test_sandboxreúne los envíos de prueba y los de un remitente sandbox, sean masivos o transaccionales; el resto se reparte entrebulkytransactionalsegún su remitente. Si se omite, incluye los tres. Las copias de respuestas que la plataforma reenvía a su buzón no se cuentan nunca.
Response
200 OKDevuelve un objeto con los campos que siguen.
totalEmailsintegersiempre presente- Cantidad de correos recibidos en el rango.
dropRatenumber (0-100)siempre presente- Porcentaje de
totalEmailsdescartados. deliveryRatenumber (0-100)siempre presente- Porcentaje de
totalEmailsentregados. bounceRatenumber (0-100)siempre presente- Porcentaje de
totalEmailsrebotados. openRatenumber (0-100)siempre presente- Porcentaje de correos entregados que fueron abiertos.
clickRatenumber (0-100)siempre presente- Porcentaje de correos entregados con al menos un clic.
unsubscribeRatenumber (0-100)siempre presente- Porcentaje de correos entregados que generaron una desuscripción.
slaComplianceRatenumber (0-100)siempre presente- Porcentaje de correos entregados dentro del SLA de latencia. Cuenta solo el envío transaccional: el de un remitente masivo no entra. Es un valor exacto.
medianDeliveryDelayMsyp95DeliveryDelayMs, en cambio, son estimados. medianDeliveryDelayMsnumber | null- Mediana de la demora de entrega del envío transaccional, en milisegundos. Es un valor estimado. Vale
nullsi no hay datos en el rango. p95DeliveryDelayMsnumber | null- Percentil 95 de la demora de entrega del envío transaccional, en milisegundos. Es un valor estimado, igual que
medianDeliveryDelayMs.
Nota
Las seis tasas y slaComplianceRate se expresan como porcentaje entre 0 y 100, redondeado a un decimal: una entrega de 97% se emite como 97.0, no como 0.97. Un rango sin datos devuelve 0.0 en todas ellas.
Notas
- Las cifras coinciden con las que muestra el panel para la misma ventana.
openRateno cuenta las aperturas que la plataforma reconoce como automáticas, como la del escáner de seguridad de Gmail.- Sin fechas, la ventana por defecto es la de retención (3 meses). Para seguir el comportamiento reciente, indique el rango de fechas. En una ventana de 3 meses, un cambio de los últimos días queda diluido en el acumulado.
Request
curl -X GET "https://$API_HOST/v1/stats/overview?start_date=2026-07-01&end_date=2026-07-31" \
-H "Authorization: Bearer $API_KEY" \
-H "X-Instance-Slug: $SLUG"
Response
{
"totalEmails": 15000,
"dropRate": 0.2,
"deliveryRate": 97.0,
"bounceRate": 1.0,
"openRate": 42.0,
"clickRate": 8.0,
"unsubscribeRate": 0.1,
"slaComplianceRate": 99.5,
"medianDeliveryDelayMs": 850.0,
"p95DeliveryDelayMs": 2400.0
}