GET

/v1/deliveries

List delivery attempts across all subscriptions, newest first.

Returns the delivery log: one record per delivery attempt, including the event type, outcome, response code from the receiving endpoint, and when the next retry is scheduled. Filter by subscription, status, or time window to trace exactly what Hooklane sent and when.

Jump to the request builder ↓

Parameters

Query parameters

subscription_id string optional

Only return deliveries for this subscription.

Example: sub_9f2c1a
status string optional

Filter by delivery outcome.

queueddeliveredfailed

Example: failed
limit integer optional

Maximum number of deliveries to return, between 1 and 100. Defaults to 20.

Example: 25
since string optional

Only deliveries created at or after this ISO 8601 timestamp.

Example: 2026-08-01T00:00:00Z

Response

A list object wrapping delivery records, newest first. `has_more` signals another page; pass the last record's `created_at` as `since` to walk forward.

200 · application/json

{
  "object": "list",
  "url": "/v1/deliveries",
  "has_more": false,
  "data": [
    {
      "id": "dlv_7Hf3kQwR",
      "object": "delivery",
      "subscription_id": "sub_9f2c1a",
      "event": "invoice.payment_failed",
      "status": "failed",
      "attempts": 3,
      "response_code": 503,
      "next_retry_at": "2026-08-28T16:40:00Z",
      "created_at": "2026-08-28T14:05:11Z"
    },
    {
      "id": "dlv_2xQp9mTa",
      "object": "delivery",
      "subscription_id": "sub_9f2c1a",
      "event": "invoice.paid",
      "status": "delivered",
      "attempts": 1,
      "response_code": 200,
      "next_retry_at": null,
      "created_at": "2026-08-28T13:58:02Z"
    }
  ]
}