# List Alert Webhooks

### List Webhooks

Retrieve a list of all webhook configurations registered for your customer. This endpoint returns the webhook IDs, URLs, creation timestamps, and descriptions, allowing you to identify which webhooks are configured and manage them accordingly.

#### Authentication

Include the following headers in your requests:

```
Access-Token: <your-access-token>
```

#### Permissions

Ensure your API user has a role with `external-api-get-webhook-list` permission.

#### Endpoint

* **URL**: `https://api.genlogs.io/alerts/webhook`
* **Method**: `GET`

#### Request Parameters

This endpoint does not require any query parameters or request body. The `customer_id` is automatically extracted from your access token.

#### Response Codes

| Code                        | Description                                               |
| --------------------------- | --------------------------------------------------------- |
| `200 OK`                    | Successfully retrieved the list of webhook configurations |
| `401 Unauthorized`          | Authentication credentials missing or incorrect           |
| `403 Forbidden`             | User lacks permission to list webhook configurations      |
| `500 Internal Server Error` | Server error occurred                                     |

#### Response Body

The response is an array of webhook objects. Each object contains:

| Field         | Type              | Description                                      |
| ------------- | ----------------- | ------------------------------------------------ |
| `id`          | string (UUID)     | Unique identifier for the webhook configuration  |
| `created_at`  | string (datetime) | ISO timestamp when the configuration was created |
| `webhook_url` | string            | The URL where notifications are sent             |
| `description` | string\|null      | Human-readable description for the webhook       |

**Response Example**

```json
[
  {
    "id": "0f8a681f-48ce-44f0-8e27-b8311c17b12a",
    "created_at": "2025-09-23T21:37:30.173622",
    "webhook_url": "https://example.com/webhook",
    "description": "Production webhook endpoint"
  },
  {
    "id": "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
    "created_at": "2025-09-24T10:15:00.000000",
    "webhook_url": "https://another.example.com/webhook",
    "description": "Development webhook endpoint"
  },
  {
    "id": "2b3c4d5e-6f78-9012-bcde-f12345678901",
    "created_at": "2025-09-25T14:20:15.123456",
    "webhook_url": "https://staging.example.com/webhook",
    "description": null
  },
  ...
]
```

**Empty Response**

If no webhooks are registered for your organization, the endpoint returns an empty array:

```json
[]
```

#### Request Example

```bash
curl -L \
  --request GET \
  --url 'https://api.genlogs.io/alerts/webhook' \
  --header 'Access-Token: YOUR_ACCESS_TOKEN' \
  --header 'x-api-key: YOUR_API_KEY'
```

#### Notes

* The response only includes webhooks registered for your organization (determined by the `customer_id` in your access token).
* The `secret` field is not included in the response for security reasons.
* Use the `id` field to reference specific webhooks when updating or managing them via other endpoints.
* The `created_at` timestamp helps identify when each webhook was registered.

> List all webhooks for the authenticated customer

## List Webhooks

> List all webhooks for the authenticated customer

```json
{"openapi":"3.1.0","info":{"title":"Alert API","version":"0.0.1"},"security":[{"APIKeyHeader":[]}],"components":{"securitySchemes":{"APIKeyHeader":{"type":"apiKey","description":"JWT Access Token required for authentication","in":"header","name":"Access-Token"}}},"paths":{"/alerts/webhook":{"get":{"tags":["Webhook Alerts"],"summary":"List Webhooks","description":"List all webhooks for the authenticated customer","operationId":"list_webhooks_alerts_webhook_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"type":"object"},"type":"array","title":"Response List Webhooks Alerts Webhook Get"}}}}}}}}}
```