Webhooks

Lister les livraisons

Récupère les tentatives de livraison paginées d'un endpoint de webhook. Filtrez par statut pour séparer les livraisons réussies de celles en échec ou en attente.

GEThttps://graph.sendcorex.com/v3.0/webhooks/:id/deliveries

Paramètres

  • idstringobligatoire

    Paramètre de chemin. ID de l'endpoint de webhook.

    ex. : "wh_123"

  • statusstringfacultatif

    Paramètre de requête. delivered ou failed (failed inclut les livraisons en attente). Omettez-le pour tout afficher.

    ex. : "failed"

  • pagenumberfacultatif

    Paramètre de requête. Numéro de page. Par défaut 1.

    ex. : 1

  • limitnumberfacultatif

    Paramètre de requête. Résultats par page. Par défaut 20, maximum 50.

    ex. : 20

Démarrage rapide

import axios from 'axios';

const response = await axios.get('https://graph.sendcorex.com/v3.0/webhooks/wh_123/deliveries?status=failed&page=1&limit=20', {
  headers: { Authorization: process.env.SENDCOREX_API_KEY },
});

console.log(response.data);

Réponse

{
  "success": true,
  "deliveries": [
    {
      "id": "del_9f3a",
      "event": "bounced",
      "status": "failed",
      "httpStatus": 500,
      "responseBody": "Internal Server Error",
      "attemptNumber": 3,
      "nextRetryAt": null,
      "createdAt": "2026-08-08T14:22:00.000Z"
    }
  ],
  "total": 47,
  "page": 1,
  "limit": 20,
  "responseTime": "38ms"
}

Champs de la réponse

  • deliveries[].id

    ID de la livraison. Transmettez-le à Relancer une livraison.

  • deliveries[].event

    L'événement en cours de livraison, par exemple bounced.

  • deliveries[].status

    Statut de la livraison, par exemple failed.

  • deliveries[].httpStatus

    Statut HTTP renvoyé par votre serveur.

  • deliveries[].responseBody

    Corps de la réponse de votre serveur.

  • deliveries[].attemptNumber

    Nombre de tentatives effectuées.

  • deliveries[].nextRetryAt

    Date de la prochaine tentative programmée, ou null.

  • deliveries[].createdAt

    Horodatage au format ISO 8601.

  • total / page / limit

    Informations de pagination.

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.

  • 401INVALID_API_KEY

    L'API key est invalide ou révoquée.