Counters: Lectura
Obtener por día
Día a día en tu zona horaria, para gráficos. Los días sin envíos vuelven como cero, así que la serie no tiene huecos.
https://g.sendcorex.com/v1/counterscommand: get_dailyRequiere el scope counters:read en tu API key.
Hasta 400 días por comando.
Argumentos
fromstringobligatorioPrimer día,
YYYY-MM-DD, inclusive, entimezone.p. ej.
"2026-10-01"tostringobligatorioÚltimo día,
YYYY-MM-DD, inclusive, entimezone.p. ej.
"2026-10-17"timezonestringopcionalUna zona horaria IANA. Los límites de los días la siguen, horario de verano incluido. Por defecto,
UTC.p. ej.
"America/Sao_Paulo"
Inicio rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/counters',
{
commands: [
{
command: "get_daily",
args: {
from: "2026-10-01",
to: "2026-10-17",
timezone: "Asia/Kuala_Lumpur"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Respuesta
{
"type": "SUCCESS",
"results": [
{
"command": "get_daily",
"id": "0",
"type": "SUCCESS",
"took_ms": 18,
"data": {
"timezone": "Asia/Kuala_Lumpur",
"daily": [
{
"day": "2026-10-17",
"delivered": 2104,
"bounced": 31,
"blocked": 5,
"complaints": 1,
"rate_limited": 4,
"total": 2144,
"delivered_rate": 98.13,
"bounce_rate": 1.45,
"blocked_rate": 0.23,
"complaint_rate": 0.05,
"rate_limited_rate": 0.19
}
],
"totals": {
"delivered": 48210,
"bounced": 612,
"blocked": 88,
"complaints": 9,
"rate_limited": 140,
"total": 49050,
"delivered_rate": 98.29,
"bounce_rate": 1.25,
"blocked_rate": 0.18,
"complaint_rate": 0.02,
"rate_limited_rate": 0.29
}
}
}
]
}Campos de la respuesta
timezoneLa zona horaria en la que se construyeron los días.
dailyUna entrada por día de
fromato, del más antiguo al más reciente, ceros incluidos. Cada una tieneday(YYYY-MM-DD) y los contadores.totalsLa suma del período.
deliveredEmails que el servidor de destino aceptó.
bouncedEmails que no pasaron: rechazados por el servidor de destino, expirados en la cola o detenidos antes del envío. El motivo de cada uno está en Bounces & Complaints.
blockedEmails que el servidor de destino rechazó como spam, por política o por reputación en el momento de la entrega. La dirección está bien: el problema fue el envío (calidad de la lista, volumen, autenticación, contenido).
complaintsDestinatarios que reportaron tu email como spam después de recibirlo: feedback loops (Outlook, Yahoo…) y reportes de abuso. No forman parte de
total, ya que esos emails ya se contaron como entregados.rate_limitedEmails que el servidor de destino siguió aplazando hasta que se agotaron los reintentos.
totaldelivered+bounced+blocked+rate_limited: cada email que obtuvo un resultado.delivered_rate / bounce_rate / blocked_rate / complaint_rate / rate_limited_rateCada contador como porcentaje de
total, con 2 decimales.0cuandototales0.
Graficar los últimos 30 días
Node.js
const to = new Date().toISOString().slice(0, 10);
const from = new Date(Date.now() - 29 * 86400_000).toISOString().slice(0, 10);
const [result] = await call({ command: 'get_daily', args: { from, to, timezone: Intl.DateTimeFormat().resolvedOptions().timeZone } });
const labels = result.data.daily.map((d) => d.day);
const delivered = result.data.daily.map((d) => d.delivered);
const bounced = result.data.daily.map((d) => d.bounced);call es cualquier helper que envía { commands: [...] } por POST a /v1/counters y devuelve results.
Errores
Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.
- 401
INVALID_API_KEYLa API key no existe, fue revocada o se desactivó en el dashboard.
- 429
RATE_LIMITEDMás de 15 solicitudes/s o 15 simultáneas para la misma IP + API key. Espera el número de segundos indicado en Retry-After.
- CMD
MISSING_SCOPELa API key no tiene `counters:read`.
- CMD
INVALID_ARGSUn argumento no es válido: un mes que no es YYYY-MM, un día que no es YYYY-MM-DD, una zona horaria desconocida, from posterior a to, un rango demasiado largo…
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.