Logs
Sachez ce qu'il est advenu de chaque e-mail
Recherchez vos livraisons par statut, destinataire, objet et date, lisez n'importe quel e-mail par son id et suivez les bounces à mesure qu'ils arrivent, le tout via un seul endpoint.
- Commandes JSON
- 50 par page
- Filtres et recherche
- 60 derniers jours
- Lecture seule
https://g.sendcorex.com/v1/logslogs:readFonctionnement
Un log par e-mail
Chaque e-mail que vous envoyez reçoit un log avec son destinataire, son objet, son statut et la réponse du serveur destinataire. L'id est celui que vous avez reçu à l'envoi.
Un endpoint, deux commandes
list_logs recherche et pagine vos logs ; get_logs les lit par id. Les deux passent par POST /v1/logs, jusqu'à 20 commandes par requête.
Conçu pour le polling
Demandez les nouveaux bounces toutes les quelques secondes sans vous soucier de la charge : les lectures répétées partagent un même résultat, et les e-mails de warm-up ne gênent jamais.
Premiers pas
Seule la key est nécessaire avant votre première requête.
- 1
Créez une API key avec logs:read
Dans le dashboard, ouvrez Developers → API Keys et créez une key avec le scope logs:read. Vous pouvez l'ajouter à une key que vous utilisez déjà pour envoyer.
Le token du webmail ne fonctionne pas ici. Les logs utilisent l'API key du dashboard.
- 2
Recherchez dans vos logs
List Logs accepte toute combinaison de statut, destinataire, mots de l'objet, domaine, expéditeur et dates, et renvoie 50 logs par page.
- 3
Lisez un e-mail
Get Logs lit jusqu'à 50 logs par id. Ajoutez include_content pour voir le HTML qui a été livré.
Le log
Les deux commandes renvoient les logs sous cette forme.
{
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"to": "ana@acme.com",
"from": "noreply@yourdomain.com",
"domain": "acme.com",
"from_domain": "yourdomain.com",
"subject": "Your order #1042 has shipped",
"status": "delivered",
"status_code": 2,
"response": "250 2.0.0 OK 1760684401 a1si123456",
"message": null,
"blocked": false,
"block_reason": null,
"retries": 0,
"tracking_id": "7CK-JDL-Y1L-20261017",
"sent_at": "2026-10-17T06:00:01.204Z",
"updated_at": "2026-10-17T06:00:02.913Z"
}statusdelivered, bounced, spam ou rate_limited. Filtrez sur un ou plusieurs.
responseLa réponse exacte du serveur destinataire. Pour un bounce, elle en donne la raison.
blockedtrue lorsque Sendcorex n'a pas envoyé à cette adresse, par exemple parce qu'elle est supprimée.
contentNe fait pas partie du log par défaut. Get Logs renvoie le HTML avec include_content.
Votre première requête
Deux recherches en une requête : vos bounces de ce mois-ci et les derniers e-mails envoyés à un client. Remplacez SENDCOREX_API_KEY par votre API key.
curl -X POST 'https://g.sendcorex.com/v1/logs' \
-H "Authorization: $SENDCOREX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"commands": [
{ "command": "list_logs", "args": { "status": "bounced", "after": "2026-10-01" } },
{ "command": "list_logs", "args": { "recipient": "ana@acme.com", "limit": 10 } }
]
}' Vous obtenez un résultat par commande, chacun avec ses logs et un next_cursor pour la page suivante. La même requête en 8 langages se trouve dans List Logs.
Cas d'usage courants
Nettoyez les bounces de votre liste
Interrogez les logs bounced toutes les quelques secondes avec after réglé sur le dernier que vous avez vu, et retirez ces adresses de votre côté.
Suivre les nouveaux bouncesRépondez à « mon e-mail est-il arrivé ? »
Recherchez un client par destinataire et affichez le statut et la réponse du serveur pour ses derniers e-mails.
List LogsVérifiez un envoi
Conservez l'id que vous recevez à l'envoi et lisez son log plus tard avec Get Logs.
Get LogsVoyez ce qui a été livré
Get Logs avec include_content renvoie le HTML, pour des écrans de support ou des audits.
Lire le corpsRéférence complète
Tout ce qui est marqué CMD est une commande envoyée via POST /v1/logs, jusqu'à 20 par requête.