View and Retry Failed Events

Off the Hook automatically retries failed deliveries up to 7 times over approximately 2 hours. If all automatic retries are exhausted, the event status changes to failed and no further attempts are made. You can inspect the full event history for any subscription and manually re-queue failed events once your endpoint is back in a healthy state.

Before retrying a failed event, confirm that your endpoint is returning 2xx responses, is publicly reachable over HTTPS, and that your signature verification code is correct. Retrying without fixing the underlying issue causes the event to fail again.

List events for a subscription

GET /v1/subscriptions/:id/events returns a paginated list of all events for the subscription, ordered from newest to oldest.

curl https://api.offthehook.dev/v1/subscriptions/sub_2QkP9aB7xN.../events \
  -H "Authorization: Bearer oth_YOUR_API_KEY"

Each item in the response is an EventView object:

{
  "items": [
    {
      "id": "evt_8xN9kP2QbA...",
      "subscriptionId": "sub_2QkP9aB7xN...",
      "kind": "wallet.transfer.broadcasted",
      "chainId": "tron:mainnet",
      "status": "failed",
      "attempts": 7,
      "deliveryCount": 0,
      "responseStatus": 500,
      "responseBody": "Internal Server Error",
      "payload": { "id": "evt_8xN9kP2QbA...", "kind": "wallet.transfer.broadcasted", "..." : "..." },
      "dateCreated": "2026-05-08T12:34:56Z"
    }
  ],
  "nextPageToken": "v1:..."
}

Field	Description
`id`	The `evt_...` identifier — also the value of the `webhook-id` delivery header
`kind`	The event type (e.g., `wallet.transfer.broadcasted`)
`status`	`pending`, `delivered`, or `failed`
`attempts`	Number of delivery attempts in the current dispatch cycle; resets to 0 when you trigger a manual retry
`deliveryCount`	Total number of successful deliveries across all cycles (monotonically increasing)
`responseStatus`	The last HTTP status code returned by your endpoint
`responseBody`	The last response body returned by your endpoint (may be truncated)
`payload`	The full webhook payload that was or will be delivered

Pass nextPageToken as a query parameter to page through a large event history:

curl "https://api.offthehook.dev/v1/subscriptions/sub_2QkP9aB7xN.../events?nextPageToken=v1:..." \
  -H "Authorization: Bearer oth_YOUR_API_KEY"

Get a specific event

GET /v1/subscriptions/:id/events/:eventId returns a single event by ID.

curl https://api.offthehook.dev/v1/subscriptions/sub_2QkP9aB7xN.../events/evt_8xN9kP2QbA... \
  -H "Authorization: Bearer oth_YOUR_API_KEY"

The response shape is the same EventView object as above.

Manually retry a failed event

POST /v1/subscriptions/:id/events/:eventId/retry re-queues a failed event for delivery. The attempts counter resets to 0 and the automatic retry schedule starts again from the beginning.

curl -X POST https://api.offthehook.dev/v1/subscriptions/sub_2QkP9aB7xN.../events/evt_8xN9kP2QbA.../retry \
  -H "Authorization: Bearer oth_YOUR_API_KEY"

The API returns 200 OK with the updated EventView when the event has been successfully re-queued. The status will be "pending" and attempts will be reset to 0. Fetch the event again after a moment to confirm delivery progress.

Get Started

Core Concepts

Guides

Reference

View and Retry Failed Events

List events for a subscription

Get a specific event

Manually retry a failed event

​List events for a subscription

​Get a specific event

​Manually retry a failed event

List events for a subscription

Get a specific event

Manually retry a failed event