Logs : Lecture
Obtenir les logs
Lisez jusqu'à 50 logs par ID d'e-mail, l'`id` que vous recevez à l'envoi. Ajoutez `include_content` pour obtenir le HTML qui a été livré.
https://g.sendcorex.com/v1/logscommand: get_logsNécessite le scope logs:read sur votre API key.
Rechercher un ID coûte la même chose quel que soit le nombre d'e-mails que vous envoyez : il n'y a aucun scan derrière.
Arguments
idsstring[]facultatifJusqu'à 50 ID d'e-mail (UUID). Les ids répétés comptent une seule fois.
ex. :
["3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"]idstringfacultatifUn seul ID d'e-mail. Utilisez ce paramètre ou
ids.ex. :
"3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"include_contentbooleanfacultatifRenvoie aussi le HTML de chaque e-mail. Avec ce paramètre, la limite est de 10 ids par commande.
ex. :
true
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/logs',
{
commands: [
{
command: "get_logs",
args: {
ids: [
"3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"00000000-0000-4000-8000-000000000000"
]
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Réponse
{
"type": "SUCCESS",
"results": [
{
"command": "get_logs",
"id": "0",
"type": "SUCCESS",
"took_ms": 18,
"data": {
"logs": [
{
"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"
}
],
"not_found": [
"00000000-0000-4000-8000-000000000000"
]
}
}
]
}Champs de la réponse
logsLes logs trouvés, dans l'ordre où vous les avez demandés.
not_foundLes ids qui n'existent pas dans votre compte, datent de plus de 60 jours ou appartiennent à des e-mails de warm-up.
logs[].idL'ID de l'e-mail (un UUID). C'est l'
idque vous recevez à l'envoi, et celui que vous passez à Get Logs.logs[].to / logs[].domainLe destinataire et le domaine du destinataire.
logs[].from_domainLe domaine de l'expéditeur (la partie après @ dans
from).logs[].fromL'adresse de l'expéditeur.
logs[].subjectLa ligne d'objet.
logs[].statusdelivered,bounced,spam,rate_limitedounot_sent.status_codeest la même chose sous forme de nombre.logs[].responseCe que le serveur destinataire a répondu, par exemple
250 2.0.0 OKou la raison du bounce550.logs[].messageUn détail supplémentaire de Sendcorex sur la livraison, le cas échéant.
logs[].blocked / logs[].block_reasontruelorsque Sendcorex n'a pas envoyé à ce destinataire (supprimé ou restreint), et pourquoi.logs[].retriesLe nombre de nouvelles tentatives de livraison.
logs[].tracking_idL'id interne de la livraison. Les webhooks de bounce et de plainte portent la même valeur.
logs[].sent_at / logs[].updated_atQuand l'e-mail a été envoyé et quand son statut a changé pour la dernière fois. ISO 8601, UTC.
logs[].content.htmlLe HTML qui a été livré. Uniquement avec
include_content: true;nulllorsque le corps n'a pas été conservé.
Lire le corps
Le corps est la partie la plus lourde d'un log, il n'est donc renvoyé que sur demande. C'est le HTML tel qu'il a été livré : si le tracking était activé, il peut contenir le pixel de suivi et des liens réécrits.
Corps de la requête
{
"commands": [
{
"command": "get_logs",
"args": {
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"include_content": true
}
}
]
}Afficher ce HTML peut charger le pixel de suivi et compter comme une ouverture. Affichez-le dans un iframe en sandbox avec les images distantes bloquées, comme le fait le dashboard.
Détails d'une page de List Logs
Enchaînez les deux commandes avec $ref : les ids de la liste passent directement dans Get Logs, en une seule requête.
Corps de la requête
{
"commands": [
{
"command": "list_logs",
"id": "bounces",
"args": {
"status": "bounced",
"limit": 10
}
},
{
"command": "get_logs",
"args": {
"ids": {
"$ref": "bounces",
"path": "logs/*/id"
},
"include_content": true
}
}
]
}Erreurs
Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.
- 401
INVALID_API_KEYL'API key n'existe pas, a été révoquée ou a été désactivée dans le dashboard.
- 429
RATE_LIMITEDPlus de 15 requêtes/s ou 15 simultanées pour la même IP + API key. Attendez le nombre de secondes indiqué dans Retry-After.
- CMD
MISSING_SCOPEL'API key n'a pas `logs:read`.
- CMD
INVALID_ARGSUn argument est invalide : statut inconnu, destinataire qui n'est pas un e-mail complet, limit hors limites, id qui n'est pas un UUID, after postérieur à before…
- CMD
INTERNALErreur serveur. Le détail n'est écrit que dans le log du serveur.