Counters

Vos chiffres d'envoi, prêts pour un graphique

Livrés, bounces, bloqués, plaintes et rate limited pour tout votre compte, par heure, jour, mois ou depuis le début, avec les taux déjà calculés.

  • Commandes JSON
  • En temps réel
  • Heure, jour, mois, total
  • N'importe quel fuseau horaire
  • Lecture seule
POSThttps://g.sendcorex.com/v1/counterscounters:read

Fonctionnement

Tout le compte

L'API, le relais SMTP et les campagnes sont comptés ensemble, une fois par e-mail, lorsque l'e-mail obtient son résultat final.

Choisissez la granularité

Depuis le début, un mois, une plage de mois, des jours dans votre propre fuseau horaire, ou des heures. Mêmes compteurs, même structure.

Taux inclus

Chaque période est fournie avec son total et les pourcentages de livrés, de bounces, de bloqués, de plaintes et de rate limited. Aucun calcul de votre côté.

Premiers pas

Seule la key est nécessaire avant votre première requête.

  1. 1

    Créez une API key avec counters:read

    Dans le dashboard, ouvrez Developers → API Keys et créez une key avec le scope counters:read, ou ajoutez-le à une key que vous utilisez déjà.

  2. 2

    Obtenez ce mois-ci

    Get Month renvoie le mois en cours avec ses taux. Get Totals vous donne tout depuis le début.

  3. 3

    Tracez un graphique

    Get Daily renvoie une entrée par jour dans votre fuseau horaire, zéros compris, prête à tracer.

Les compteurs

Chaque commande renvoie les compteurs sous cette forme, pour la période demandée.

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

Acceptés par le serveur destinataire.

bounced

Ne sont pas passés. La raison de chacun se trouve dans Bounces & Complaints.

blocked

Refusés comme spam ou par politique au moment de la livraison. L'adresse est bonne, l'envoi ne l'était pas.

complaints

Destinataires qui vous ont signalé comme spam après avoir reçu l'e-mail. Ne font pas partie du total.

*_rate

Chaque compteur en pourcentage du total, avec 2 décimales.

Votre première requête

Depuis le début et ce mois-ci, en une requête. Remplacez SENDCOREX_API_KEY par votre 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" } }
  ]
}'

Vous obtenez un résultat par commande : les totaux pour la première, le mois avec ses taux pour la seconde. La même requête en 8 langages se trouve dans Run Commands.

Cas d'usage courants

Un graphique de délivrabilité dans votre app

Get Daily sur les 30 derniers jours dans le fuseau horaire de l'utilisateur, et tracez les livrés face aux bounces.

Graphique des 30 derniers jours

Suivez un envoi en temps réel

Get Hourly pour aujourd'hui et voyez le taux de bounce d'une campagne pendant son envoi.

Get Hourly

Rapport mensuel

Get Months pour l'année : une ligne par mois avec ses taux, plus le total.

Get Months

Découvrez pourquoi ils ont rebondi

Les compteurs vous disent combien. Bounces & Complaints vous dit quelles adresses et pourquoi.

Bounces & Complaints

Référence complète

Tout ce qui est marqué CMD est une commande envoyée via POST /v1/counters, jusqu'à 20 par requête.