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

# List packages

Authentication: required

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

## Paths

- `GET` `/api/fleet/epm/packages`
- `GET` `/s/{space_id}/api/fleet/epm/packages`

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

## Query string parameters

- `excludeInstallStatus` (boolean · default: false) — optional
  Whether to exclude the install status of each package. Enabling this option will opt in to caching for the response via `cache-control` headers. If you don't need up-to-date installation info for a package, and are querying for a list of available packages, providing this flag can improve performance substantially.
- `prerelease` (boolean · default: false) — optional
  Whether to return prerelease versions of packages (e.g. beta, rc, preview)
- `experimental` (boolean · default: false) — optional — deprecated
- `category` (string) — optional

## Responses

#### `200`

OK

`application/json`

- `items` (object[])
  - `description` (string)
  - `download` (string)
  - `icons` (string)
  - `installationInfo` (object)
    - `created_at` (string)
    - `experimental_data_stream_features` (object[])
      - `data_stream` (string)
      - `features` (object)
        - `doc_value_only_numeric` (boolean) — nullable
        - `doc_value_only_other` (boolean) — nullable
        - `synthetic_source` (boolean) — nullable
        - `tsdb` (boolean) — nullable
    - `install_format_schema_version` (string)
    - `install_kibana_space_id` (string)
    - `install_source` (enum)
      Values: `registry`, `upload`, `bundled`
    - `install_status` (enum)
      Values: `installed`, `installing`, `install_failed`
    - `installed_es` (object)
      - `deferred` (boolean)
      - `id` (string)
      - `type` (enum)
        Values: `component_template`, `ingest_pipeline`, `index_template`, `ilm_policy`, `transform`, `data_stream_ilm_policy`
    - `installed_kibana` (object)
      - `id` (string)
      - `type` (enum)
        Values: `dashboard`, `visualization`, `search`, `index-pattern`, `map`, `lens`, `ml-module`, `security-rule`, `csp_rule_template`
    - `latest_executed_state` (object)
      Latest successfully executed state in package install state machine
      - `error` (string)
      - `name` (enum)
        Values: `create_restart_installation`, `install_kibana_assets`, `install_ilm_policies`, `install_ml_model`, `install_index_template_pipelines`, `remove_legacy_templates`, `update_current_write_indices`, `install_transforms`, `delete_previous_pipelines`, `save_archive_entries_from_assets_map`, `update_so`
      - `started_at` (string)
    - `latest_install_failed_attempts` (object[])
      Latest failed install errors
      - `created_at` (string)
      - `error` (object)
        - `message` (string)
        - `name` (string)
        - `stack` (string)
      - `target_version` (string)
    - `name` (string)
    - `namespaces` (string[])
    - `type` (string)
    - `updated_at` (string)
    - `verification_key_id` (string) — nullable
    - `verification_status` (enum)
      Values: `verified`, `unverified`, `unknown`
    - `version` (string)
  - `name` (string)
  - `path` (string)
  - `savedObject` (object) — deprecated
  - `status` (string)
  - `title` (string)
  - `type` (string)
  - `version` (string)
- `response` (object[]) — deprecated
  Same fields as `items`
#### `400`

Generic Error

`application/json`

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

#### Console

```console
GET kbn:/api/fleet/epm/packages
```

#### curl

```curl
curl -X GET "${KIBANA_URL}/api/fleet/epm/packages" \
  -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
{
  "items": [
    {
      "description": "string",
      "download": "string",
      "icons": "string",
      "installationInfo": {
        "created_at": "string",
        "experimental_data_stream_features": [
          {
            "data_stream": "string"
          }
        ],
        "install_format_schema_version": "string",
        "install_kibana_space_id": "string",
        "install_source": "registry",
        "install_status": "installed",
        "installed_es": {
          "deferred": false,
          "id": "string",
          "type": "component_template"
        },
        "installed_kibana": {
          "id": "string",
          "type": "dashboard"
        },
        "latest_executed_state": {
          "error": "string",
          "name": "create_restart_installation",
          "started_at": "string"
        },
        "latest_install_failed_attempts": [
          {
            "created_at": "string",
            "target_version": "string"
          }
        ],
        "name": "string",
        "namespaces": [
          "string"
        ],
        "type": "string",
        "updated_at": "string",
        "verification_key_id": "string",
        "verification_status": "verified",
        "version": "string"
      },
      "name": "string",
      "path": "string",
      "savedObject": {},
      "status": "string",
      "title": "string",
      "type": "string",
      "version": "string"
    }
  ],
  "response": [
    {
      "description": "string",
      "download": "string",
      "icons": "string",
      "installationInfo": {
        "created_at": "string",
        "experimental_data_stream_features": [
          {
            "data_stream": "string"
          }
        ],
        "install_format_schema_version": "string",
        "install_kibana_space_id": "string",
        "install_source": "registry",
        "install_status": "installed",
        "installed_es": {
          "deferred": false,
          "id": "string",
          "type": "component_template"
        },
        "installed_kibana": {
          "id": "string",
          "type": "dashboard"
        },
        "latest_executed_state": {
          "error": "string",
          "name": "create_restart_installation",
          "started_at": "string"
        },
        "latest_install_failed_attempts": [
          {
            "created_at": "string",
            "target_version": "string"
          }
        ],
        "name": "string",
        "namespaces": [
          "string"
        ],
        "type": "string",
        "updated_at": "string",
        "verification_key_id": "string",
        "verification_status": "verified",
        "version": "string"
      },
      "name": "string",
      "path": "string",
      "savedObject": {},
      "status": "string",
      "title": "string",
      "type": "string",
      "version": "string"
    }
  ]
}
```

#### 400

`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": "string",
  "message": "string",
  "statusCode": 0
}
```