Counters
Tus números de envío, listos para un gráfico
Entregados, bounces, bloqueados, quejas y rate limited de toda tu cuenta, por hora, día, mes o desde siempre, con las tasas ya calculadas.
- Comandos JSON
- En tiempo real
- Hora, día, mes, total
- Cualquier zona horaria
- Solo lectura
https://g.sendcorex.com/v1/counterscounters:readCómo funciona
Toda la cuenta
API, SMTP relay y campañas se cuentan juntos, una vez por email, cuando el email obtiene su resultado final.
Elige la granularidad
Desde siempre, un mes, un rango de meses, días en tu propia zona horaria u horas. Mismos contadores, misma estructura.
Tasas incluidas
Cada período viene con su total y los porcentajes de entregados, bounces, bloqueados, quejas y rate limited. Sin cálculos de tu lado.
Primeros pasos
Solo necesitas la key antes de tu primera solicitud.
- 1
Crea una API key con counters:read
En el dashboard, abre Developers → API Keys y crea una key con el scope counters:read, o añádelo a una key que ya uses.
- 2
Obtén este mes
Get Month devuelve el mes actual con sus tasas. Get Totals te da todo desde el principio.
- 3
Dibuja un gráfico
Get Daily devuelve una entrada por día en tu zona horaria, ceros incluidos, lista para graficar.
Los contadores
Cada comando devuelve contadores con esta estructura, para el período que pediste.
{
"month": "2026-10",
"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
}deliveredAceptados por el servidor de destino.
bouncedNo pasaron. El motivo de cada uno está en Bounces & Complaints.
blockedRechazados como spam o por política en el momento de la entrega. La dirección está bien, el envío no.
complaintsDestinatarios que te reportaron como spam después de recibir el email. No forman parte del total.
*_rateCada contador como porcentaje del total, con 2 decimales.
Tu primera solicitud
Desde siempre y este mes, en una solicitud. Reemplaza SENDCOREX_API_KEY por tu API key.
curl -X POST 'https://g.sendcorex.com/v1/counters' \
-H "Authorization: $SENDCOREX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"commands": [
{ "command": "get_totals" },
{ "command": "get_month", "args": { "month": "2026-10" } }
]
}'Obtienes un resultado por comando: los totales en el primero, el mes con sus tasas en el segundo. La misma solicitud en 8 lenguajes está en Run Commands.
Tareas comunes
Un gráfico de entregabilidad en tu app
Get Daily de los últimos 30 días en la zona horaria del usuario, y grafica entregados frente a bounces.
Graficar los últimos 30 díasSigue un envío en tiempo real
Get Hourly de hoy y mira la tasa de bounce de una campaña mientras sale.
Get HourlyAverigua por qué rebotaron
Los contadores te dicen cuántos. Bounces & Complaints te dice qué direcciones y por qué.
Bounces & ComplaintsReferencia completa
Todo lo marcado como CMD es un comando enviado a través de POST /v1/counters, hasta 20 por solicitud.