Counters
Seus números de envio, prontos para um gráfico
Entregues, bounces, bloqueados, reclamações e rate limited da sua conta inteira, por hora, dia, mês ou desde o início, com as taxas já calculadas.
- Comandos JSON
- Em tempo real
- Hora, dia, mês, total
- Qualquer fuso horário
- Somente leitura
https://g.sendcorex.com/v1/counterscounters:readComo funciona
A conta inteira
API, SMTP relay e campanhas são contados juntos, uma vez por email, quando o email recebe seu resultado final.
Escolha a granularidade
Desde o início, um mês, um intervalo de meses, dias no seu próprio fuso horário ou horas. Mesmos contadores, mesmo formato.
Taxas incluídas
Cada período vem com o total e as porcentagens de entregues, bounce, bloqueados, reclamações e rate limited. Nenhuma conta do seu lado.
Primeiros passos
Só a key é necessária antes da sua primeira requisição.
- 1
Crie uma API key com counters:read
No dashboard, abra Developers → API Keys e crie uma key com o escopo counters:read, ou adicione-o a uma key que você já usa.
- 2
Veja este mês
Get Month retorna o mês atual com suas taxas. Get Totals traz tudo desde o início.
- 3
Monte um gráfico
Get Daily retorna uma entrada por dia no seu fuso horário, zeros incluídos, pronta para plotar.
Os contadores
Todo comando retorna contadores neste formato, para o período que você pediu.
{
"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
}deliveredAceitos pelo servidor de destino.
bouncedNão passaram. O motivo de cada um está em Bounces & Complaints.
blockedRecusados como spam ou por política no momento da entrega. O endereço está ok, o envio não.
complaintsDestinatários que reportaram você como spam depois de receber o email. Não fazem parte do total.
*_rateCada contador como porcentagem do total, com 2 casas decimais.
Sua primeira requisição
Desde o início e este mês, em uma requisição. Substitua SENDCOREX_API_KEY pela sua 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" } }
]
}'Você recebe um resultado por comando: os totais no primeiro, o mês com suas taxas no segundo. A mesma requisição em 8 linguagens está em Run Commands.
Tarefas comuns
Um gráfico de entregabilidade no seu app
Get Daily dos últimos 30 dias no fuso horário do usuário, e plote entregues contra bounces.
Gráfico dos últimos 30 diasAcompanhe um envio em tempo real
Get Hourly de hoje e veja a taxa de bounce de uma campanha enquanto ela sai.
Get HourlyDescubra por que deram bounce
Os contadores dizem quantos. Bounces & Complaints diz quais endereços e por quê.
Bounces & ComplaintsReferência completa
Tudo marcado como CMD é um comando enviado por POST /v1/counters, até 20 por requisição.