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
https://g.sendcorex.com/v1/counterscounters:readHow 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
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
Get this month
Get Month returns the current month with its rates. Get Totals gives you everything since the start.
- 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
}deliveredAccepted by the recipient server.
bouncedDid not get through. The reason of each one is in Bounces & Complaints.
blockedRefused as spam or by policy at delivery time. The address is fine, the send was not.
complaintsRecipients who reported you as spam after receiving the email. Not part of total.
*_rateEach 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 daysWatch a send in real time
Get Hourly for today and see the bounce rate of a campaign while it goes out.
Get HourlyMonthly report
Get Months for the year: one line per month with its rates, plus the total.
Get MonthsFind out why they bounced
The counters tell you how many. Bounces & Complaints tells you which addresses and why.
Bounces & ComplaintsFull reference
Everything marked CMD is a command sent through POST /v1/counters, up to 20 per request.