---
type: api
title: Get an alert by identifier
description: **Spaces method and path for this operation:**
url: https://www.elastic.co/elastic/docs-builder/docs/4493/api/doc/kibana/v8/operation/operation-legacygetalert
resource: https://www.elastic.co/elastic/docs-builder/docs/4493/api/doc/kibana/v8/operation/operation-legacygetalert
products:
  - Kibana
---

# Get an alert by identifier

deprecated

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

## Paths

- `GET` `/api/alerts/alert/{alertId}`
- `GET` `/s/{space_id}/api/alerts/alert/{alertId}`

#### Path parameters

- `alertId` (string) — required
  The identifier for the alert.
  Example: `41893910-6bca-11eb-9e0d-85d233e3ee35`

## Description

Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.

Deprecated in 7.13.0. Use the get rule API instead.

## Authentication

- Api key: `Authorization: <value>`
  These APIs use key-based authentication. You must create an API key and use the encoded value in the request header. For example: `Authorization: ApiKey base64AccessApiKey`
- Basic: `Authorization: Basic <credentials>`

## Responses

#### `200`

Indicates a successful call.

`application/json`

- `actions` (object[])
- `alertTypeId` (string)
- `apiKeyOwner` (string) — nullable
- `createdAt` (string · format: date-time)
  The date and time that the alert was created.
- `createdBy` (string)
  The identifier for the user that created the alert.
- `enabled` (boolean)
  Indicates whether the alert is currently enabled.
- `executionStatus` (object)
  - `lastExecutionDate` (string · format: date-time)
  - `status` (string)
- `id` (string)
  The identifier for the alert.
- `muteAll` (boolean)
- `mutedInstanceIds` (string[]) — nullable
- `name` (string)
  The name of the alert.
- `notifyWhen` (string)
- `params` (object)
- `schedule` (object)
  - `interval` (string)
- `scheduledTaskId` (string)
- `tags` (string[])
- `throttle` (string) — nullable
- `updatedAt` (string)
- `updatedBy` (string) — nullable
  The identifier for the user that updated this alert most recently.
#### `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/alert/41893910-6bca-11eb-9e0d-85d233e3ee35
```

#### curl

```curl
curl -X GET "${KIBANA_URL}/api/alerts/alert/41893910-6bca-11eb-9e0d-85d233e3ee35" \
  -H "Authorization: ApiKey ${API_KEY}"
```