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

Como 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. 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. 2

    Veja este mês

    Get Month retorna o mês atual com suas taxas. Get Totals traz tudo desde o início.

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

Aceitos pelo servidor de destino.

bounced

Não passaram. O motivo de cada um está em Bounces & Complaints.

blocked

Recusados como spam ou por política no momento da entrega. O endereço está ok, o envio não.

complaints

Destinatários que reportaram você como spam depois de receber o email. Não fazem parte do total.

*_rate

Cada 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 dias

Acompanhe um envio em tempo real

Get Hourly de hoje e veja a taxa de bounce de uma campanha enquanto ela sai.

Get Hourly

Relatório mensal

Get Months do ano: uma linha por mês com suas taxas, mais o total.

Get Months

Descubra por que deram bounce

Os contadores dizem quantos. Bounces & Complaints diz quais endereços e por quê.

Bounces & Complaints

Referência completa

Tudo marcado como CMD é um comando enviado por POST /v1/counters, até 20 por requisição.