Counters

Your sending numbers, ready for a chart

Delivered, bounced, blocked, complaints and rate limited for your whole account, by hour, day, month or all time, with the rates already calculated.

  • JSON commands
  • Live
  • Hour, day, month, total
  • Any timezone
  • Read-only
POSThttps://g.sendcorex.com/v1/counterscounters:read

How it works

The whole account

API, SMTP relay and campaigns are counted together, once per email, when the email gets its final result.

Pick the granularity

All time, one month, a range of months, days in your own timezone, or hours. Same counters, same shape.

Rates included

Every period comes with its total and the delivered, bounce, blocked, complaint and rate-limited percentages. No math on your side.

Get started

Only the key is needed before your first request.

  1. 1

    Create an API key with counters:read

    In the dashboard, open Developers → API Keys and create a key with the counters:read scope, or add it to a key you already use.

  2. 2

    Get this month

    Get Month returns the current month with its rates. Get Totals gives you everything since the start.

  3. 3

    Draw a chart

    Get Daily returns one entry per day in your timezone, zeros included, ready to plot.

The counters

Every command returns counters in this shape, for the period you asked for.

{
  "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

Accepted by the recipient server.

bounced

Did not get through. The reason of each one is in Bounces & Complaints.

blocked

Refused as spam or by policy at delivery time. The address is fine, the send was not.

complaints

Recipients who reported you as spam after receiving the email. Not part of total.

*_rate

Each counter as a percentage of total, with 2 decimals.

Your first request

All time and this month, in one request. Replace SENDCOREX_API_KEY with your 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" } }
  ]
}'

You get one result per command: totals for the first, the month with its rates for the second. The same request in 8 languages is in Run Commands.

Common tasks

A deliverability chart in your app

Get Daily for the last 30 days in the user timezone, and plot delivered against bounced.

Charting the last 30 days

Watch a send in real time

Get Hourly for today and see the bounce rate of a campaign while it goes out.

Get Hourly

Monthly report

Get Months for the year: one line per month with its rates, plus the total.

Get Months

Find out why they bounced

The counters tell you how many. Bounces & Complaints tells you which addresses and why.

Bounces & Complaints

Full reference

Everything marked CMD is a command sent through POST /v1/counters, up to 20 per request.