# GET /api/webhooks

> Webhooks - List all Webhooks

Lists the configured webhook subscriptions, newest first. The signing secret is never part of a read response; only the has_secret flag tells you whether one is set.

- **Endpoint:** `GET /api/webhooks`
- **Group:** Webhooks
- **Since:** v1.0.0
- **Defined in:** `RestApi/Controllers/WebhooksController.php`

## Headers

| Field | Type | Description |
| --- | --- | --- |
| `authtoken` | String | Authentication token, generated from admin area |

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `active` | Number | no | Optional Only return enabled (1) or disabled (0) webhooks |
| `limit` | Number | no | Optional Page size, 1 to 200 Default: `50`. |
| `offset` | Number | no | Optional Rows to skip Default: `0`. |

## Request example

```bash
curl -X GET "https://yoursite.com/index.php/api/webhooks" \
  -H "authtoken: YOUR_API_TOKEN"
```

## Responses

### Success - Success-Response:

```json
HTTP/1.1 200 OK
[
  {
    "id": 3,
    "name": "Ops sync",
    "url": "https://hooks.example.com/rise",
    "events": ["invoices.created", "tickets.*"],
    "headers": { "X-Env": "production" },
    "active": 1,
    "timeout": 10,
    "retry_count": 1,
    "last_triggered": "2026-07-22 14:32:10",
    "success_count": 128,
    "failure_count": 2,
    "created_by": 1,
    "created_at": "2026-07-01 09:12:44",
    "updated_at": "2026-07-22 14:32:10",
    "has_secret": true,
    "signature_header": "X-Rise-Signature"
  }
]
```

### Error - Error-Response:

```json
HTTP/1.1 404 Not Found
{ "status": false, "messages": { "error": "No data were found" } }
```

---

Part of the [REST API for RISE CRM](https://risecrm.themesic.com/apiguide/) documentation.
Full page: https://risecrm.themesic.com/apiguide/webhooks/get-webhooks/