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

## List webhooks

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

Every webhook on this instance, newest first, with status and last delivery times. Paged by offset.

### Filters

| Name | Type | Description |
| --- | --- | --- |
| `_offset` | integer | Rows to skip. Default 0. |

### Range and paging

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

### Returns

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

### Responses

- `200` One page of webhooks
- `401` This bind requires the instance token, and it was missing or wrong

### Example

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

```json
{
  "data": [
    {
      "id": "3f1c2a9e-8b7d-4c21-9a55-6e0d4b2f7c18",
      "name": "sbtc-moves",
      "status": "active",
      "kind": "chain",
      "format": "standard-webhooks",
      "url": "https://example.com/webhooks/sbtc",
      "lastDeliveryAt": "2026-09-22T14:03:11.402Z",
      "lastSuccessAt": "2026-09-22T14:03:11.402Z",
      "circuitOpenedAt": null,
      "circuitFailures": 0,
      "managedBy": null,
      "createdAt": "2026-09-20T09:12:45.118Z",
      "updatedAt": "2026-09-20T09:12:45.118Z"
    }
  ]
}
```