---
type: api
title: Get cases for an alert
description: You must have `read` privileges for the **Cases** feature in the **Management**, **Observability**, or **Security** section of the Kibana feature privileges, depending on the owner of the cases you're seeking.
url: https://www.elastic.co/elastic/docs-builder/docs/4493/api/doc/kibana/v0/operation/operation-getcasesbyalertdefaultspace
resource: https://www.elastic.co/elastic/docs-builder/docs/4493/api/doc/kibana/v0/operation/operation-getcasesbyalertdefaultspace
products:
  - Kibana
---

# Get cases for an alert

Availability: Preview

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

## Paths

- `GET` `/api/cases/alerts/{alertId}`

#### Path parameters

- `alertId` (string) — required
  An identifier for the alert.

## Description

You must have `read` privileges for the **Cases** feature in the **Management**, **Observability**, or **Security** section of the Kibana feature privileges, depending on the owner of the cases you're seeking.

## 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>`

## Query string parameters

- `owner` (union oneOf) — optional
  A filter to limit the response to a specific set of applications. If this parameter is omitted, the response contains information about all the cases that the user has access to read.
  Values: `cases`, `observability`, `securitySolution`

## Responses

#### `200`

Indicates a successful call.

`application/json`

Type: `object[] · max items: 10000`

An array; each item has these fields:

- `createdAt` (string · format: date-time)
  When the case was created.
- `description` (string)
  The case description.
- `id` (string)
  The case identifier.
- `status` (enum)
  The status of the case.
  Values: `closed`, `in-progress`, `open`
- `title` (string)
  The case title.
- `totals` (object)
  Counts of alerts, events, and user comments attached to a case.
  - `alerts` (integer)
    Number of alert attachments on the case.
  - `events` (integer)
    Number of event attachments on the case.
  - `userComments` (integer)
    Number of user comment attachments on the case.
#### `401`

Authorization information is missing or invalid.

`application/json`

- `error` (string)
- `message` (string)
- `statusCode` (integer)
## Code examples

#### Console

```console
GET kbn:/api/cases/alerts/09f0c261e39e36351d75995b78bb83673774d1bc2cca9df2d15f0e5c0a99a540
```

#### curl

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

## Response examples

#### Cases associated with a given alert.

```json
[
  {
    "createdAt": "2020-02-19T23:06:33.798Z",
    "description": "Investigating suspicious activity",
    "id": "06116b80-e1c3-11ec-be9b-9b1838238ee6",
    "status": "open",
    "title": "security_case",
    "totals": {
      "alerts": 1,
      "events": 0,
      "userComments": 0
    }
  }
]
```

#### Authorization information is missing or invalid.

```json
{
  "error": "Unauthorized",
  "message": "Unable to authenticate with the provided credentials.",
  "statusCode": 401
}
```