--- type: api title: Get stack versions description: By default, retrieves only the available Elastic Stack versions. To retrieve all of the Elastic Stack versions, use the `show_deleted parameter`. url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud/operation/operation-get-version-stacks resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud/operation/operation-get-version-stacks products: - Elastic Cloud Hosted --- # Get stack versions - Server: `https://api.elastic-cloud.com/api/v1` ## Paths - `GET` `/stack/versions` ## Description By default, retrieves only the available Elastic Stack versions. To retrieve all of the Elastic Stack versions, use the `show_deleted parameter`. ## Query String Parameters - `show_deleted` (boolean · default: false) Whether to show deleted stack versions or not - `show_unusable` (boolean · default: false) Whether to show versions that are unusable by the authenticated user ## Response The list of all available Elastic Stack versions are retrieved, including the template version and structure. `application/json` - `stacks` ([] StackVersionConfig) - `version` (string) Stack version - `template` ({} StackVersionTemplateInfo) The template information for an Elastic Stack version. - `template_version` (string) Template version - `hashes` ([] StackVersionTemplateFileHash) Relative paths of files with SHA-256 hashes that contains the template - `path` (string) File path relative to template's root - `hash` (string) SHA-256 hash of a file - `elasticsearch` ({} StackVersionElasticsearchConfig) The Elasticsearch configuration for an Elastic Stack version. - `docker_image` (string) Docker image for the Elasticsearch - `plugins` ([] string) List of available plugins - `default_plugins` ([] string) List of default plugins - `blacklist` ([] string) List of configuration options that cannot be overridden by user settings - `node_types` ([] StackVersionNodeType) Node types that are supported by this stack version - `node_type` (string) Type of the node (master, data, ...) - `name` (string) Name of the node type - `description` (string) Description of the node type - `settings` (object) Settings that are applied to all nodes of this type - `capacity_constraints` ({} StackVersionInstanceCapacityConstraint) The Elasticsearch instance, Kibana instance, APM Server capacity constraints for an Elastic Stack node type. - `min` (integer) Min capacity of the instances - `max` (integer) Max capacity of the instances - `compatible_node_types` ([] string) Node types that are compatible with this one - `mandatory` (boolean) Flag to specify a node type is mandatory in a cluster's plan - `settings` (object) Settings that are applied to all nodes of this type - `capacity_constraints` ({} StackVersionInstanceCapacityConstraint) The Elasticsearch instance, Kibana instance, APM Server capacity constraints for an Elastic Stack node type. - `min` (integer) Min capacity of the instances - `max` (integer) Max capacity of the instances - `compatible_node_types` ([] string) Node types that are compatible with this one - `kibana` ({} StackVersionKibanaConfig) The Kibana configuration for an Elastic Stack version. - `version` (string) Version of Kibana - `docker_image` (string) Docker image for the kibana - `blacklist` ([] string) List of configuration options that cannot be overridden by user settings - `settings` (object) Settings that are applied to all nodes of this type - `capacity_constraints` ({} StackVersionInstanceCapacityConstraint) The Elasticsearch instance, Kibana instance, APM Server capacity constraints for an Elastic Stack node type. - `min` (integer) Min capacity of the instances - `max` (integer) Max capacity of the instances - `compatible_node_types` ([] string) Node types that are compatible with this one - `apm` ({} StackVersionApmConfig) The APM Server configuration for an Elastic Stack version. - `version` (string) Version of APM - `docker_image` (string) Docker image for the APM - `blacklist` ([] string) List of configuration options that cannot be overridden by user settings - `settings` (object) Settings that are applied to all nodes of this type - `capacity_constraints` ({} StackVersionInstanceCapacityConstraint) The Elasticsearch instance, Kibana instance, APM Server capacity constraints for an Elastic Stack node type. - `min` (integer) Min capacity of the instances - `max` (integer) Max capacity of the instances - `compatible_node_types` ([] string) Node types that are compatible with this one - `appsearch` ({} StackVersionAppSearchConfig) AppSearch related configuration of an Elastic Stack version - `version` (string) Version of AppSearch - `docker_image` (string) Docker image for the AppSearch - `blacklist` ([] string) List of configuration options that cannot be overridden by user settings - `settings` (object) Settings that are applied to all nodes of this type - `capacity_constraints` ({} StackVersionInstanceCapacityConstraint) The Elasticsearch instance, Kibana instance, APM Server capacity constraints for an Elastic Stack node type. - `min` (integer) Min capacity of the instances - `max` (integer) Max capacity of the instances - `compatible_node_types` ([] string) Node types that are compatible with this one - `node_types` ([] StackVersionNodeType) Node types that are supported by this stack version - `node_type` (string) Type of the node (master, data, ...) - `name` (string) Name of the node type - `description` (string) Description of the node type - `settings` (object) Settings that are applied to all nodes of this type - `capacity_constraints` ({} StackVersionInstanceCapacityConstraint) The Elasticsearch instance, Kibana instance, APM Server capacity constraints for an Elastic Stack node type. - `min` (integer) Min capacity of the instances - `max` (integer) Max capacity of the instances - `compatible_node_types` ([] string) Node types that are compatible with this one - `mandatory` (boolean) Flag to specify a node type is mandatory in a cluster's plan - `metadata` ({} StackVersionMetadata) The metadata for the Elastic Stack. - `notes` (string) Notes for administrator - `pre_release` (boolean) Indicates that the stack pack version is not GA and is not supposed to be used in production - `min_platform_version` (string) The minimum version of the platform that the stack pack version is compatible with - `min_wire_compatibility_version` (string) The minimum version required for performing a rolling upgrade to this stack version. - `min_index_compatibility_version` (string) The minimum version required for performing a full cluster restart upgrade to this stack version. - `schema_version` (integer) The schema version of the stack pack version - `is_fips` (boolean) Is this a fips stackpack - `deleted` (boolean) Identifies that the Elastic Stack version is marked for deletion - `upgradable_to` ([] string) Stack Versions that this version can upgrade to - `min_upgradable_from` (string) The minimum version recommended to upgrade this version. - `whitelisted` (boolean) Whether or not this version is whitelisted. This is only relevant in EC (SaaS) and is not sent in ECE. - `accessible` (boolean) Whether or not this version is accessible by the calling user. This is only relevant in EC (SaaS) and is not sent in ECE. - `rolling_upgrade_compatible_versions` ([] string) List of versions that can be upgraded to the current version of the stackpack ## Code Examples #### Console ```console GET /stack/versions ``` #### curl ```curl curl -X GET "https://api.elastic-cloud.com/api/v1/stack/versions" ```