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

Fonctionnement

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. 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. 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. 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"
}
status

delivered, bounced, spam ou rate_limited. Filtrez sur un ou plusieurs.

response

La réponse exacte du serveur destinataire. Pour un bounce, elle en donne la raison.

blocked

true lorsque Sendcorex n'a pas envoyé à cette adresse, par exemple parce qu'elle est supprimée.

content

Ne 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 bounces

Ré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 Logs

Vérifiez un envoi

Conservez l'id que vous recevez à l'envoi et lisez son log plus tard avec Get Logs.

Get Logs

Voyez ce qui a été livré

Get Logs avec include_content renvoie le HTML, pour des écrans de support ou des audits.

Lire le corps

Référence complète

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