# Available Alerts

## Get Alert Types

`alerting.available_alerts.list(AvailableAlertListParams**kwargs)  -> AvailableAlertListResponse`

**get** `/accounts/{account_id}/alerting/v3/available_alerts`

Gets a list of all alert types for which an account is eligible.

### Parameters

- `account_id: str`

  The account id

### Returns

- `Dict[str, List[AvailableAlertListResponseItem]]`

  - `description: Optional[str]`

    Describes the alert type.

  - `display_name: Optional[str]`

    Alert type name.

  - `filter_options: Optional[List[object]]`

    Format of additional configuration options (filters) for the alert type. Data type of filters during policy creation: Array of strings.

  - `type: Optional[str]`

    Use this value when creating and updating a notification policy.

### Example

```python
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
available_alerts = client.alerting.available_alerts.list(
    account_id="023e105f4ecef8ad9ca31a8372d0c353",
)
print(available_alerts)
```

#### Response

```json
{
  "errors": [
    {
      "message": "message",
      "code": 1000
    }
  ],
  "messages": [
    {
      "message": "message",
      "code": 1000
    }
  ],
  "success": true,
  "result": {
    "Origin Monitoring": [
      {
        "description": "High levels of 5xx HTTP errors at your origin.",
        "display_name": "Origin Error Rate Alert",
        "filter_options": [
          {
            "AvailableValues": null,
            "ComparisonOperator": "==",
            "Key": "zones",
            "Range": "1-n"
          },
          {
            "AvailableValues": [
              {
                "Description": "Service-Level Objective of 99.7",
                "ID": "99.7"
              },
              {
                "Description": "Service-Level Objective of 99.8",
                "ID": "99.8"
              }
            ],
            "ComparisonOperator": ">=",
            "Key": "slo",
            "Range": "0-1"
          }
        ],
        "type": "http_alert_origin_error"
      }
    ]
  }
}
```

## Domain Types

### Available Alert List Response

- `Dict[str, List[AvailableAlertListResponseItem]]`

  - `description: Optional[str]`

    Describes the alert type.

  - `display_name: Optional[str]`

    Alert type name.

  - `filter_options: Optional[List[object]]`

    Format of additional configuration options (filters) for the alert type. Data type of filters during policy creation: Array of strings.

  - `type: Optional[str]`

    Use this value when creating and updating a notification policy.