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

## List recent replays across webhooks

`GET /api/webhooks/replays` (self-hosted instances only)

Replays still scanning or delivering, plus any started in the last 24 hours, across every webhook on this instance. Newest first.

### Range and paging

| Name | Type | Description |
| --- | --- | --- |
| `_limit` | integer | Page size, 1 to 50. Default 20. |

### Returns

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

### Responses

- `200` Recent replays with live progress
- `401` This bind requires the instance token, and it was missing or wrong

### Example

```bash
curl http://127.0.0.1:3800/api/webhooks/replays \
  -H "Authorization: Bearer $INSTANCE_TOKEN"
```

```json
{
  "data": [
    {
      "replayId": "a41f09c3d27e8b65",
      "webhookId": "3f1c2a9e-8b7d-4c21-9a55-6e0d4b2f7c18",
      "status": "done",
      "fromBlock": 8650000,
      "toBlock": 8700000,
      "total": 312,
      "processed": 312,
      "pending": 0,
      "delivered": 309,
      "gaveUp": 3,
      "startedAt": "2026-09-22T14:00:02.000Z",
      "finishedAt": "2026-09-22T14:06:40.000Z",
      "error": null
    }
  ]
}
```
