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
POSThttps://g.sendcorex.com/v1/counterscounters:read

Có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. 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. 2

    Obtén este mes

    Get Month devuelve el mes actual con sus tasas. Get Totals te da todo desde el principio.

  3. 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
}
delivered

Aceptados por el servidor de destino.

bounced

No pasaron. El motivo de cada uno está en Bounces & Complaints.

blocked

Rechazados como spam o por política en el momento de la entrega. La dirección está bien, el envío no.

complaints

Destinatarios que te reportaron como spam después de recibir el email. No forman parte del total.

*_rate

Cada 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ías

Sigue un envío en tiempo real

Get Hourly de hoy y mira la tasa de bounce de una campaña mientras sale.

Get Hourly

Informe mensual

Get Months del año: una línea por mes con sus tasas, más el total.

Get Months

Averigua por qué rebotaron

Los contadores te dicen cuántos. Bounces & Complaints te dice qué direcciones y por qué.

Bounces & Complaints

Referencia completa

Todo lo marcado como CMD es un comando enviado a través de POST /v1/counters, hasta 20 por solicitud.