--- type: api title: Get stack version description: Retrieves the Elastic Stack version and template. url: https://www.elastic.co/elastic/docs-builder/docs/4493/api/doc/cloud-enterprise/operation/operation-get-version-stack resource: https://www.elastic.co/elastic/docs-builder/docs/4493/api/doc/cloud-enterprise/operation/operation-get-version-stack products: - Elastic Cloud Enterprise --- # Get stack version ## Paths - `GET` `/stack/versions/{version}` #### Path parameters - `version` (string) — required The Elastic Stack version. For example, `5.3.1` or `5.0.0-RC4`. ## Description Retrieves the Elastic Stack version and template. ## Authentication - Basic: `Authorization: Basic ` - Api key: `Authorization: ` ## Responses #### `200` The Elastic Stack version is found. `application/json` - `version` (string) Stack version - `template` (object) The template information for an Elastic Stack version. - `template_version` (string) Template version - `hashes` (object[]) 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` (object) 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` (object[]) 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` (object) The Elasticsearch instance, Kibana instance, APM Server capacity constraints for an Elastic Stack node type. - `min` (integer · format: int32) Min capacity of the instances - `max` (integer · format: int32) 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` (object) The Elasticsearch instance, Kibana instance, APM Server capacity constraints for an Elastic Stack node type. - `min` (integer · format: int32) Min capacity of the instances - `max` (integer · format: int32) Max capacity of the instances - `compatible_node_types` (string[]) Node types that are compatible with this one - `kibana` (object) 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` (object) The Elasticsearch instance, Kibana instance, APM Server capacity constraints for an Elastic Stack node type. - `min` (integer · format: int32) Min capacity of the instances - `max` (integer · format: int32) Max capacity of the instances - `compatible_node_types` (string[]) Node types that are compatible with this one - `apm` (object) 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` (object) The Elasticsearch instance, Kibana instance, APM Server capacity constraints for an Elastic Stack node type. - `min` (integer · format: int32) Min capacity of the instances - `max` (integer · format: int32) Max capacity of the instances - `compatible_node_types` (string[]) Node types that are compatible with this one - `appsearch` (object) 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` (object) The Elasticsearch instance, Kibana instance, APM Server capacity constraints for an Elastic Stack node type. - `min` (integer · format: int32) Min capacity of the instances - `max` (integer · format: int32) Max capacity of the instances - `compatible_node_types` (string[]) Node types that are compatible with this one - `node_types` (object[]) 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` (object) The Elasticsearch instance, Kibana instance, APM Server capacity constraints for an Elastic Stack node type. - `min` (integer · format: int32) Min capacity of the instances - `max` (integer · format: int32) 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 - `enterprise_search` (object) EnterpriseSearch related configuration of an Elastic Stack version - `version` (string) Version of EnterpriseSearch - `docker_image` (string) Docker image for the EnterpriseSearch - `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` (object) The Elasticsearch instance, Kibana instance, APM Server capacity constraints for an Elastic Stack node type. - `min` (integer · format: int32) Min capacity of the instances - `max` (integer · format: int32) Max capacity of the instances - `compatible_node_types` (string[]) Node types that are compatible with this one - `node_types` (object[]) 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` (object) The Elasticsearch instance, Kibana instance, APM Server capacity constraints for an Elastic Stack node type. - `min` (integer · format: int32) Min capacity of the instances - `max` (integer · format: int32) 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` (object) 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 · format: int32) 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 #### `404` The Elastic Stack version can't be found. (code: `stackpack.version_not_found`) `application/json` - `errors` (object[]) A list of errors that occurred in the failing request - `code` (string) A structured code representing the error type that occurred - `message` (string) A human readable message describing the error that occurred - `fields` (string[]) If the error can be tied to a specific field or fields in the user request, this lists those fields ##### Response headers - `x-cloud-error-codes` (enum) The error codes associated with the response ## Code examples #### curl ```curl curl -X GET "${API_URL}/stack/versions/${VERSION}" \ -u "${USERNAME}:${PASSWORD}" ```