---
type: api
title: Get a package
description: **Spaces method and path for this operation:**
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana-serverless/operation/operation-get-fleet-epm-packages-pkgname-pkgversion
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana-serverless/operation/operation-get-fleet-epm-packages-pkgname-pkgversion
products:
  - Kibana
---

# Get a package

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

## Paths

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

- [Api key auth](/elastic/docs-builder/docs/4371/api/doc/kibana-serverless/authentication#apikeyauth)

#### Path Parameters

- `pkgName` (string)
  Package name
- `pkgVersion` (string) — optional, leave it out to use `/api/fleet/epm/packages/{pkgName}`
  Package version

## Description

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

Get information about a specific version of a package.

## Query String Parameters

- `ignoreUnverified` (boolean)
  When true, returns the package even if the signature cannot be verified
- `prerelease` (boolean)
  When true, include prerelease versions
- `full` (boolean)
  When true, return the full package info including assets
- `withMetadata` (boolean · default: false)
  When true, include package metadata such as whether it has package policies

## Responses

#### `200`

Successful response

`application/json`

- `item` ({})
  - `agent` (object)
    - `privileges` (object)
      - `root` (boolean)
  - `asset_tags` ([] object · max: 1000)
    - `asset_ids` ([] string · max: 1000)
    - `asset_types` ([] string · max: 100)
    - `text` (string)
  - `assets` (map string to object)
  - `categories` ([] string · max: 100)
  - `conditions` (object)
    - `deprecated` ({})
      - `description` (string · max: 4096)
      - `replaced_by` (map string to string)
      - `since` (string · max: 50)
    - `elastic` (object)
      - `capabilities` ([] string · max: 10)
      - `subscription` (string)
    - `kibana` (object)
      - `version` (string)
  - `data_streams` ([] string to object · max: 1000)
  - `deprecated` ({})
    - `description` (string · max: 4096)
    - `replaced_by` (map string to string)
    - `since` (string · max: 50)
  - `description` (string)
  - `discovery` (object)
    - `datasets` ([] object · max: 100)
      - `name` (string)
    - `fields` ([] object · max: 100)
      - `name` (string)
  - `download` (string)
  - `elasticsearch` (map string to object)
  - `format_version` (string)
  - `icons` ([] object · max: 100)
    - `dark_mode` (boolean)
    - `path` (string)
    - `size` (string)
    - `src` (string)
    - `title` (string)
    - `type` (string)
  - `installationInfo` ({})
    - `additional_spaces_installed_kibana` (map string to object)
    - `created_at` (string)
    - `experimental_data_stream_features` ([] object · max: 100)
      - `data_stream` (string · max: 1024)
      - `features` (object)
        - `doc_value_only_numeric` (boolean)
        - `doc_value_only_other` (boolean)
        - `synthetic_source` (boolean)
        - `tsdb` (boolean)
    - `install_format_schema_version` (string)
    - `install_source` (enum)
      Values: `registry`, `upload`, `bundled`, `custom`
    - `install_status` (enum)
      Values: `installed`, `installing`, `install_failed`
    - `installed_es` ([] object · max: 10000)
      - `customDataStreamOriginDataset` (string)
      - `customDataStreamOriginType` (string)
      - `deferred` (boolean)
      - `id` (string)
      - `type` (enum)
        Values: `index`, `index_template`, `component_template`, `ingest_pipeline`, `ilm_policy`, `data_stream_ilm_policy`, `transform`, `ml_model`, `knowledge_base`, `esql_view`
      - `version` (string)
    - `installed_kibana` ([] object · max: 10000)
      - `deferred` (boolean)
      - `id` (string)
      - `originId` (string)
      - `type` (union enum | string)
        Values: `dashboard`, `lens`, `visualization`, `search`, `index-pattern`, `map`, `ml-module`, `security-rule`, `csp-rule-template`, `osquery-pack-asset`, `osquery-saved-query`, `tag`
    - `installed_kibana_space_id` (string)
    - `is_rollback_ttl_expired` (boolean)
    - `latest_executed_state` (object)
      - `error` (string)
      - `name` (string)
      - `started_at` (string)
    - `latest_install_failed_attempts` ([] object · max: 10)
      - `created_at` (string)
      - `error` (object)
        - `message` (string)
        - `name` (string)
        - `stack` (string)
      - `missing_assets` ([] object · max: 10000)
        - `id` (string)
        - `type` (string)
      - `target_version` (string)
    - `name` (string)
    - `namespaces` ([] string · max: 100)
    - `previous_version` (string) — nullable
    - `rolled_back` (boolean)
    - `type` (string)
    - `updated_at` (string)
    - `verification_key_id` (string) — nullable
    - `verification_status` (enum)
      Values: `unverified`, `verified`, `unknown`
    - `version` (string)
  - `internal` (boolean)
  - `keepPoliciesUpToDate` (boolean)
  - `latestVersion` (string)
  - `license` (string)
  - `licensePath` (string)
  - `name` (string)
  - `notice` (string)
  - `owner` (object)
    - `github` (string)
    - `type` (enum)
      Values: `elastic`, `partner`, `community`
  - `path` (string)
  - `policy_templates` ([] string to object · max: 1000)
  - `readme` (string)
  - `release` (enum)
    Values: `ga`, `beta`, `experimental`
  - `screenshots` ([] object · max: 100)
    - `dark_mode` (boolean)
    - `path` (string)
    - `size` (string)
    - `src` (string)
    - `title` (string)
    - `type` (string)
  - `signature_path` (string)
  - `source` (object)
    - `license` (string)
  - `status` (string)
  - `title` (string)
  - `type` (union enum | string)
    Values: `integration`, `input`, `content`
  - `var_groups` ([] object · max: 100)
    - `description` (string)
    - `name` (string)
    - `options` ([] object · max: 100)
      - `description` (string)
      - `hide_in_deployment_modes` ([] enum  · max: 2)
        Values: `default`, `agentless`
      - `name` (string)
      - `title` (string)
      - `vars` ([] string · max: 100)
    - `selector_title` (string)
    - `title` (string)
  - `vars` ([] string to object · max: 1000)
  - `version` (string)
- `metadata` ({})
  - `has_policies` (boolean)
#### `400`

Bad Request

`application/json`

- `attributes` (object)
- `error` (string)
- `errorType` (string)
- `message` (string)
- `statusCode` (number)
## Code Examples

#### Console

```console
GET /api/fleet/epm/packages/{pkgName}/{pkgVersion}
```

#### curl

```curl
curl -X GET "https://{kibana_url}/api/fleet/epm/packages/{pkgName}/{pkgVersion}"
```

## Response Examples

#### Get package info

Package details and installation status

```json
{
  "item": {
    "assets": {
      "kibana": {
        "dashboard": [],
        "index_pattern": []
      }
    },
    "categories": [
      "cloud"
    ],
    "description": "Collect logs and metrics from Amazon Web Services",
    "name": "aws",
    "status": "installed",
    "title": "AWS",
    "version": "2.10.0"
  }
}
```

#### Generic error response

Example of a generic error response

```json
{
  "error": "Bad Request",
  "message": "An error message describing what went wrong",
  "statusCode": 400
}
```