> ## Documentation Index
> Fetch the complete documentation index at: https://docs.partnero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List webhooks

> Retrieve a list of all configured webhooks

## Endpoint

```
GET https://api.partnero.com/v1/webhooks
```

## Query Parameters

| Parameter | Type    | Default | Description                         |
| --------- | ------- | ------- | ----------------------------------- |
| `limit`   | integer | 10      | Number of results per page (10-100) |
| `page`    | integer | 1       | Page number for pagination          |

## Request

```bash cURL theme={null}
curl --location 'https://api.partnero.com/v1/webhooks' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

## Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": [
      {
        "key": "uLbBzVvN7ARX",
        "name": "Demo",
        "url": "https://webhook.site/dc398096-ec94-4e2e-a161-7e9969168ffe",
        "is_active": true,
        "signature": "Sjn3sNnmh14yk6zb",
        "events": [
          "partner.created"
        ]
      }
    ],
    "links": {
      "first": "https://api.partnero.com/v1/webhooks?page=1",
      "last": null,
      "prev": null,
      "next": null
    },
    "meta": {
      "current_page": 1,
      "from": 1,
      "path": "https://api.partnero.com/v1/webhooks",
      "per_page": 10,
      "to": 1
    },
    "status": 1
  }
  ```
</ResponseExample>

### Response Fields

| Field              | Type    | Description                               |
| ------------------ | ------- | ----------------------------------------- |
| `data`             | array   | Array of webhook objects                  |
| `data[].key`       | string  | Unique webhook identifier                 |
| `data[].name`      | string  | Webhook name                              |
| `data[].url`       | string  | Destination URL for events                |
| `data[].is_active` | boolean | Whether webhook is active                 |
| `data[].signature` | string  | Secret for verifying webhook authenticity |
| `data[].events`    | array   | List of subscribed events                 |