<!-- source: https://secondlayer.tools/docs/api-reference#list-dead-webhook-events -->

## List dead-lettered events

`GET /api/webhooks/{id}/dead` (self-hosted instances only)

Events that used up `maxRetries` without a 2xx, newest failure first, up to 100. Requeue one to try it again.

### Path parameters

| Name | Type | Description |
| --- | --- | --- |
| `id` | string, required | Webhook id (UUID), as returned by create or list. |

### Returns

A cursor envelope; `data` holds `WebhookDeadEvent` objects.

### Responses

- `200` Dead-lettered events
- `401` This bind requires the instance token, and it was missing or wrong
- `404` No webhook with this id

### Example

```bash
curl http://127.0.0.1:3800/api/webhooks/{id}/dead \
  -H "Authorization: Bearer $INSTANCE_TOKEN"
```

```json
{
  "data": [
    {
      "id": "5e8d3b17-a2c4-4f90-b6e1-7d0c29f4a853",
      "eventType": "chain.ft_transfer.apply",
      "attempt": 7,
      "blockHeight": 8700076,
      "txId": "0x839ef4720020f5aba341630e8965851f8537bc8fc99a856091093780c886a8be",
      "payload": {
        "action": "apply",
        "block_hash": "0xf9ff01e876f9276abc9f0fc79a4fbefc500bf2b93ed1effd0ef637ef84e10604",
        "block_height": 8700076,
        "block_time": "2026-05-01T11:59:48.000Z",
        "tx_id": "0x839ef4720020f5aba341630e8965851f8537bc8fc99a856091093780c886a8be",
        "canonical": true,
        "trigger": "ft_transfer",
        "event": {
          "tx_id": "0x839ef4720020f5aba341630e8965851f8537bc8fc99a856091093780c886a8be",
          "type": "ft_transfer_event",
          "event_index": 45,
          "data": {
            "amount": "764749",
            "sender": "SM1FKXGNZJWSTWDWXQZJNF7B5TV5ZB235JTCXYXKD.dlmm-pool-stx-sbtc-v-1-bps-15",
            "recipient": "SP1GBRTAXY96ZDYRQY4GR0M9JTXVYD2FGFRGV60FJ",
            "asset_identifier": "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token::sbtc-token"
          }
        }
      },
      "failedAt": "2026-09-22T16:41:02.877Z",
      "createdAt": "2026-09-22T14:03:10.915Z"
    }
  ]
}
```