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

# Get package

Authentication: required

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

## Paths

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

#### 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.
- `pkgName` (string) — required
- `pkgVersion` (string) — required

## Query string parameters

- `ignoreUnverified` (boolean) — optional
  Ignore if the package is fails signature verification
- `full` (boolean) — optional
  Return all fields from the package manifest, not just those supported by the Elastic Package Registry
- `prerelease` (boolean · default: false) — optional
  Whether to return prerelease versions of packages (e.g. beta, rc, preview)

## Responses

#### `200`

OK

`application/json`

- `item` (object)
  - `agent` (object)
    - `privileges` (object)
      - `root` (boolean)
  - `asset_tags` (object[])
    - `asset_ids` (string[])
    - `asset_types` (string[])
    - `text` (string)
  - `assets` (string[])
  - `categories` (string[])
  - `conditions` (object)
    - `elasticsearch` (object)
      - `subscription` (enum)
        Values: `basic`, `gold`, `platinum`, `enterprise`
    - `kibana` (object)
      - `versions` (string)
  - `data_streams` (object[])
    - `ingeset_pipeline` (string)
    - `name` (string)
    - `package` (string)
    - `release` (string)
    - `title` (string)
    - `type` (string)
    - `vars` (object[])
      - `default` (string)
      - `name` (string)
  - `description` (string)
  - `discovery` (object)
    - `fields` (object[])
      - `name` (string)
  - `download` (string)
  - `elasticsearch` (object)
    - `privileges` (object)
      - `cluster` (string[])
  - `format_version` (string)
  - `icons` (string[])
  - `internal` (boolean)
  - `name` (string)
  - `owner` (object)
    - `github` (string)
    - `type` (enum)
      Values: `elastic`, `partner`, `community`
  - `path` (string)
  - `readme` (string)
  - `release` (enum) — deprecated
    release label is deprecated, derive from the version instead (packages follow semver)
    Values: `experimental`, `beta`, `ga`
  - `screenshots` (object[])
    - `path` (string)
    - `size` (string)
    - `src` (string)
    - `title` (string)
    - `type` (string)
  - `source` (object)
    - `license` (enum)
      Values: `Apache-2.0`, `Elastic-2.0`
  - `title` (string)
  - `type` (enum)
    Values: `integration`, `input`, `content`
  - `version` (string)
- `keepPoliciesUpToDate` (boolean)
- `latestVersion` (string)
- `licensePath` (string)
- `notice` (string)
- `savedObject` (object) — deprecated
- `status` (enum)
  Values: `installed`, `installing`, `install_failed`, `not_installed`
#### `400`

Generic Error

`application/json`

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

#### Console

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

#### curl

```curl
curl -X GET "${KIBANA_URL}/api/fleet/epm/packages/${PKG_NAME}/${PKG_VERSION}" \
  -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
{
  "item": {
    "agent": {
      "privileges": {
        "root": false
      }
    },
    "asset_tags": [
      {
        "asset_ids": [
          "string"
        ],
        "asset_types": [
          "string"
        ],
        "text": "string"
      }
    ],
    "assets": [
      "string"
    ],
    "categories": [
      "string"
    ],
    "conditions": {
      "elasticsearch": {
        "subscription": "basic"
      },
      "kibana": {
        "versions": "string"
      }
    },
    "data_streams": [
      {
        "ingeset_pipeline": "string",
        "name": "string",
        "package": "string",
        "release": "string",
        "title": "string",
        "type": "string",
        "vars": [
          {
            "default": "string",
            "name": "string"
          }
        ]
      }
    ],
    "description": "string",
    "discovery": {
      "fields": [
        {
          "name": "string"
        }
      ]
    },
    "download": "string",
    "elasticsearch": {
      "privileges": {
        "cluster": [
          "string"
        ]
      }
    },
    "format_version": "string",
    "icons": [
      "string"
    ],
    "internal": false,
    "name": "string",
    "owner": {
      "github": "string",
      "type": "elastic"
    },
    "path": "string",
    "readme": "string",
    "release": "experimental",
    "screenshots": [
      {
        "path": "string",
        "size": "string",
        "src": "string",
        "title": "string",
        "type": "string"
      }
    ],
    "source": {
      "license": "Apache-2.0"
    },
    "title": "string",
    "type": "integration",
    "version": "string"
  },
  "keepPoliciesUpToDate": false,
  "latestVersion": "string",
  "licensePath": "string",
  "notice": "string",
  "savedObject": {},
  "status": "installed"
}
```

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