---
type: api
title: Get the alert types
description: Deprecated in 7.13.0. Use the get rule types API instead.
url: https://www.elastic.co/docs/api/doc/kibana/v8/operation/operation-legacygetalerttypes
resource: https://www.elastic.co/docs/api/doc/kibana/v8/operation/operation-legacygetalerttypes
products:
  - Kibana
---

# Get the alert types

deprecated

Authentication: required

- Server: `https://{kibana_url}`

## Paths

- `GET` `/api/alerts/alerts/list_alert_types`
- `GET` `/s/{space_id}/api/alerts/alerts/list_alert_types`

#### Path parameters

- `space_id` (string) — optional
  An identifier for the space. If `space_id` is not provided in the URL, the default space is used. Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.

## Description

Deprecated in 7.13.0. Use the get rule types API instead.

## Responses

#### `200`

Indicates a successful call.

`application/json`

Type: `object[]`

An array; each item has these fields:

- `actionGroups` (object[])
  An explicit list of groups for which the alert type can schedule actions, each with the action group's unique ID and human readable name. Alert actions validation uses this configuration to ensure that groups are valid.
  - `id` (string)
  - `name` (string)
- `actionVariables` (object)
  A list of action variables that the alert type makes available via context and state in action parameter templates, and a short human readable description. The Alert UI will use this information to prompt users for these variables in action parameter editors.
  - `context` (object[])
    - `description` (string)
    - `name` (string)
  - `params` (object[])
    - `description` (string)
    - `name` (string)
  - `state` (object[])
    - `description` (string)
    - `name` (string)
- `authorizedConsumers` (object)
  The list of the plugins IDs that have access to the alert type.
- `defaultActionGroupId` (string)
  The default identifier for the alert type group.
- `enabledInLicense` (boolean)
  Indicates whether the rule type is enabled based on the subscription.
- `id` (string)
  The unique identifier for the alert type.
- `isExportable` (boolean)
  Indicates whether the alert type is exportable in Saved Objects Management UI.
- `minimumLicenseRequired` (string)
  The subscriptions required to use the alert type.
- `name` (string)
  The descriptive name of the alert type.
- `producer` (string)
  An identifier for the application that produces this alert type.
- `recoveryActionGroup` (object)
  An action group to use when an alert instance goes from an active state to an inactive one. If it is not specified, the default recovered action group is used.
  - `id` (string)
  - `name` (string)
#### `401`

Authorization information is missing or invalid.

`application/json`

- `error` (enum)
  Values: `Unauthorized`
- `message` (string)
- `statusCode` (enum)
  Values: `401`
## Code examples

#### Console

```console
GET kbn:/api/alerts/alerts/list_alert_types
```

#### curl

```curl
curl -X GET "${KIBANA_URL}/api/alerts/alerts/list_alert_types" \
  -H "Authorization: ApiKey ${API_KEY}"
```

## Response examples

#### 200

`application/json`

Generated from the API spec. Values are representative. Unions use the first variant; deeply nested or large bodies may omit fields.

```json
[
  {
    "actionGroups": [
      {
        "id": "string",
        "name": "string"
      }
    ],
    "actionVariables": {
      "context": [
        {
          "description": "string",
          "name": "string"
        }
      ],
      "params": [
        {
          "description": "string",
          "name": "string"
        }
      ],
      "state": [
        {
          "description": "string",
          "name": "string"
        }
      ]
    },
    "authorizedConsumers": {},
    "defaultActionGroupId": "string",
    "enabledInLicense": false,
    "id": "string",
    "isExportable": false,
    "minimumLicenseRequired": "string",
    "name": "string",
    "producer": "string",
    "recoveryActionGroup": {
      "id": "string",
      "name": "string"
    }
  }
]
```

#### 401

`application/json`

Generated from the API spec. Values are representative. Unions use the first variant; deeply nested or large bodies may omit fields.

```json
{
  "error": "Unauthorized",
  "message": "string",
  "statusCode": 401
}
```