Webhooks

List Deliveries

Retrieve paginated delivery attempts for a webhook endpoint. Filter by status to separate successful deliveries from failed or pending ones.

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

Parameters

  • idstringrequired

    Path parameter. Webhook endpoint ID.

    e.g. "wh_123"

  • statusstringoptional

    Query parameter. delivered or failed (failed includes pending). Omit for all.

    e.g. "failed"

  • pagenumberoptional

    Query parameter. Page number. Default 1.

    e.g. 1

  • limitnumberoptional

    Query parameter. Results per page. Default 20, max 50.

    e.g. 20

Quick start

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);

Response

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

Response fields

  • deliveries[].id

    Delivery ID. Pass it to Retry Delivery.

  • deliveries[].event

    The event that was being delivered, for example bounced.

  • deliveries[].status

    Delivery status, for example failed.

  • deliveries[].httpStatus

    HTTP status your server answered with.

  • deliveries[].responseBody

    Body your server answered with.

  • deliveries[].attemptNumber

    How many attempts were made.

  • deliveries[].nextRetryAt

    When the next attempt is scheduled, or null.

  • deliveries[].createdAt

    ISO 8601 timestamp.

  • total / page / limit

    Pagination info.

Errors

HTTP-level errors return type, code and message. Errors marked CMD come back inside the command result, with HTTP 200.

  • 401INVALID_API_KEY

    The API key is invalid or revoked.