---
type: api
title: List asset criticality records
description: **Spaces method and path for this operation:**
url: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/kibana/v8/operation/operation-findassetcriticalityrecords
resource: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/kibana/v8/operation/operation-findassetcriticalityrecords
products:
  - Kibana
---

# List asset criticality records

Authentication: required

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

## Paths

- `GET` `/api/asset_criticality/list`
- `GET` `/s/{space_id}/api/asset_criticality/list`

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

List asset criticality records, paging, sorting and filtering as needed.

## Query string parameters

- `sort_field` (enum) — optional
  The field to sort by.
  Values: `id_value`, `id_field`, `criticality_level`, `@timestamp`
- `sort_direction` (enum) — optional
  The order to sort by.
  Values: `asc`, `desc`
- `page` (integer · min: 1) — optional
  The page number to return.
- `per_page` (integer · min: 1 · max: 1000) — optional
  The number of records to return per page.
- `kuery` (string) — optional
  The kuery to filter by.

## Response

Successfully retrieved asset criticality records

`application/json`

- `page` (integer · min: 1)
- `per_page` (integer · min: 1 · max: 1000)
- `records` (object[])
  - `id_field` (enum)
    Values: `host.name`, `user.name`, `service.name`
  - `id_value` (string)
    The ID value of the asset.
  - `criticality_level` (enum)
    The criticality level of the asset.
    Values: `low_impact`, `medium_impact`, `high_impact`, `extreme_impact`
  - `asset` (object)
    - `criticality` (enum)
      The criticality level of the asset.
      Values: `low_impact`, `medium_impact`, `high_impact`, `extreme_impact`
  - `host` (object)
    - `asset` (object)
      - `criticality` (enum)
        The criticality level of the asset.
        Values: `low_impact`, `medium_impact`, `high_impact`, `extreme_impact`
    - `name` (string)
  - `service` (object)
    - `asset` (object)
      - `criticality` (enum)
        The criticality level of the asset.
        Values: `low_impact`, `medium_impact`, `high_impact`, `extreme_impact`
    - `name` (string)
  - `user` (object)
    - `asset` (object)
      - `criticality` (enum)
        The criticality level of the asset.
        Values: `low_impact`, `medium_impact`, `high_impact`, `extreme_impact`
    - `name` (string)
  - `@timestamp` (string · format: date-time)
    The time the record was created or updated.
- `total` (integer · min: 0)
## Code examples

#### Console

```console
GET kbn:/api/asset_criticality/list
```

#### curl

```curl
curl -X GET "${KIBANA_URL}/api/asset_criticality/list" \
  -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
{
  "page": 1,
  "per_page": 10,
  "records": [
    {
      "@timestamp": "2024-08-02T14:40:35.705Z",
      "asset": {
        "criticality": "medium_impact"
      },
      "criticality_level": "medium_impact",
      "host": {
        "asset": {
          "criticality": "medium_impact"
        },
        "name": "my_other_host"
      },
      "id_field": "host.name",
      "id_value": "my_other_host"
    },
    {
      "@timestamp": "2024-08-02T11:15:34.290Z",
      "asset": {
        "criticality": "high_impact"
      },
      "criticality_level": "high_impact",
      "host": {
        "asset": {
          "criticality": "high_impact"
        },
        "name": "my_host"
      },
      "id_field": "host.name",
      "id_value": "my_host"
    }
  ],
  "total": 2
}
```