Skip to main content
GET
/
stack
/
versions
Get stack versions
curl --request GET \
  --url https://api.elastic-cloud.com/api/v1/stack/versions \
  --header 'Authorization: <api-key>'
{
  "stacks": [
    {
      "accessible": "<boolean>",
      "apm": {
        "blacklist": [
          "<string>",
          "<string>"
        ],
        "capacity_constraints": {
          "max": "<integer>",
          "min": "<integer>"
        },
        "compatible_node_types": [
          "<string>",
          "<string>"
        ],
        "docker_image": "<string>",
        "settings": {},
        "version": "<string>"
      },
      "appsearch": {
        "blacklist": [
          "<string>",
          "<string>"
        ],
        "capacity_constraints": {
          "max": "<integer>",
          "min": "<integer>"
        },
        "compatible_node_types": [
          "<string>",
          "<string>"
        ],
        "docker_image": "<string>",
        "node_types": [
          {
            "capacity_constraints": {
              "max": "<integer>",
              "min": "<integer>"
            },
            "compatible_node_types": [
              "<string>",
              "<string>"
            ],
            "description": "<string>",
            "mandatory": "<boolean>",
            "name": "<string>",
            "node_type": "<string>",
            "settings": {}
          },
          {
            "capacity_constraints": {
              "max": "<integer>",
              "min": "<integer>"
            },
            "compatible_node_types": [
              "<string>",
              "<string>"
            ],
            "description": "<string>",
            "mandatory": "<boolean>",
            "name": "<string>",
            "node_type": "<string>",
            "settings": {}
          }
        ],
        "settings": {},
        "version": "<string>"
      },
      "deleted": "<boolean>",
      "elasticsearch": {
        "blacklist": [
          "<string>",
          "<string>"
        ],
        "capacity_constraints": {
          "max": "<integer>",
          "min": "<integer>"
        },
        "compatible_node_types": [
          "<string>",
          "<string>"
        ],
        "default_plugins": [
          "<string>",
          "<string>"
        ],
        "docker_image": "<string>",
        "node_types": [
          {
            "capacity_constraints": {
              "max": "<integer>",
              "min": "<integer>"
            },
            "compatible_node_types": [
              "<string>",
              "<string>"
            ],
            "description": "<string>",
            "mandatory": "<boolean>",
            "name": "<string>",
            "node_type": "<string>",
            "settings": {}
          },
          {
            "capacity_constraints": {
              "max": "<integer>",
              "min": "<integer>"
            },
            "compatible_node_types": [
              "<string>",
              "<string>"
            ],
            "description": "<string>",
            "mandatory": "<boolean>",
            "name": "<string>",
            "node_type": "<string>",
            "settings": {}
          }
        ],
        "plugins": [
          "<string>",
          "<string>"
        ],
        "settings": {}
      },
      "kibana": {
        "blacklist": [
          "<string>",
          "<string>"
        ],
        "capacity_constraints": {
          "max": "<integer>",
          "min": "<integer>"
        },
        "compatible_node_types": [
          "<string>",
          "<string>"
        ],
        "docker_image": "<string>",
        "settings": {},
        "version": "<string>"
      },
      "metadata": {
        "min_index_compatibility_version": "<string>",
        "min_platform_version": "<string>",
        "min_wire_compatibility_version": "<string>",
        "notes": "<string>",
        "pre_release": "<boolean>",
        "schema_version": "<integer>"
      },
      "min_upgradable_from": "<string>",
      "template": {
        "hashes": [
          {
            "hash": "<string>",
            "path": "<string>"
          },
          {
            "hash": "<string>",
            "path": "<string>"
          }
        ],
        "template_version": "<string>"
      },
      "upgradable_to": [
        "<string>",
        "<string>"
      ],
      "version": "<string>",
      "whitelisted": "<boolean>"
    },
    {
      "accessible": "<boolean>",
      "apm": {
        "blacklist": [
          "<string>",
          "<string>"
        ],
        "capacity_constraints": {
          "max": "<integer>",
          "min": "<integer>"
        },
        "compatible_node_types": [
          "<string>",
          "<string>"
        ],
        "docker_image": "<string>",
        "settings": {},
        "version": "<string>"
      },
      "appsearch": {
        "blacklist": [
          "<string>",
          "<string>"
        ],
        "capacity_constraints": {
          "max": "<integer>",
          "min": "<integer>"
        },
        "compatible_node_types": [
          "<string>",
          "<string>"
        ],
        "docker_image": "<string>",
        "node_types": [
          {
            "capacity_constraints": {
              "max": "<integer>",
              "min": "<integer>"
            },
            "compatible_node_types": [
              "<string>",
              "<string>"
            ],
            "description": "<string>",
            "mandatory": "<boolean>",
            "name": "<string>",
            "node_type": "<string>",
            "settings": {}
          },
          {
            "capacity_constraints": {
              "max": "<integer>",
              "min": "<integer>"
            },
            "compatible_node_types": [
              "<string>",
              "<string>"
            ],
            "description": "<string>",
            "mandatory": "<boolean>",
            "name": "<string>",
            "node_type": "<string>",
            "settings": {}
          }
        ],
        "settings": {},
        "version": "<string>"
      },
      "deleted": "<boolean>",
      "elasticsearch": {
        "blacklist": [
          "<string>",
          "<string>"
        ],
        "capacity_constraints": {
          "max": "<integer>",
          "min": "<integer>"
        },
        "compatible_node_types": [
          "<string>",
          "<string>"
        ],
        "default_plugins": [
          "<string>",
          "<string>"
        ],
        "docker_image": "<string>",
        "node_types": [
          {
            "capacity_constraints": {
              "max": "<integer>",
              "min": "<integer>"
            },
            "compatible_node_types": [
              "<string>",
              "<string>"
            ],
            "description": "<string>",
            "mandatory": "<boolean>",
            "name": "<string>",
            "node_type": "<string>",
            "settings": {}
          },
          {
            "capacity_constraints": {
              "max": "<integer>",
              "min": "<integer>"
            },
            "compatible_node_types": [
              "<string>",
              "<string>"
            ],
            "description": "<string>",
            "mandatory": "<boolean>",
            "name": "<string>",
            "node_type": "<string>",
            "settings": {}
          }
        ],
        "plugins": [
          "<string>",
          "<string>"
        ],
        "settings": {}
      },
      "kibana": {
        "blacklist": [
          "<string>",
          "<string>"
        ],
        "capacity_constraints": {
          "max": "<integer>",
          "min": "<integer>"
        },
        "compatible_node_types": [
          "<string>",
          "<string>"
        ],
        "docker_image": "<string>",
        "settings": {},
        "version": "<string>"
      },
      "metadata": {
        "min_index_compatibility_version": "<string>",
        "min_platform_version": "<string>",
        "min_wire_compatibility_version": "<string>",
        "notes": "<string>",
        "pre_release": "<boolean>",
        "schema_version": "<integer>"
      },
      "min_upgradable_from": "<string>",
      "template": {
        "hashes": [
          {
            "hash": "<string>",
            "path": "<string>"
          },
          {
            "hash": "<string>",
            "path": "<string>"
          }
        ],
        "template_version": "<string>"
      },
      "upgradable_to": [
        "<string>",
        "<string>"
      ],
      "version": "<string>",
      "whitelisted": "<boolean>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Query Parameters

​
show_deleted
string

Whether to show deleted stack versions or not

Example:

"false"

​
show_unusable
string

Whether to show versions that are unusable by the authenticated user

Example:

"false"

Response

200 - application/json

The list of all available Elastic Stack versions are retrieved, including the template version and structure.

​
stacks
object[]
Example:
[
  {
    "accessible": "<boolean>",
    "apm": {
      "blacklist": ["<string>", "<string>"],
      "capacity_constraints": { "max": "<integer>", "min": "<integer>" },
      "compatible_node_types": ["<string>", "<string>"],
      "docker_image": "<string>",
      "settings": {},
      "version": "<string>"
    },
    "appsearch": {
      "blacklist": ["<string>", "<string>"],
      "capacity_constraints": { "max": "<integer>", "min": "<integer>" },
      "compatible_node_types": ["<string>", "<string>"],
      "docker_image": "<string>",
      "node_types": [
        {
          "capacity_constraints": { "max": "<integer>", "min": "<integer>" },
          "compatible_node_types": ["<string>", "<string>"],
          "description": "<string>",
          "mandatory": "<boolean>",
          "name": "<string>",
          "node_type": "<string>",
          "settings": {}
        },
        {
          "capacity_constraints": { "max": "<integer>", "min": "<integer>" },
          "compatible_node_types": ["<string>", "<string>"],
          "description": "<string>",
          "mandatory": "<boolean>",
          "name": "<string>",
          "node_type": "<string>",
          "settings": {}
        }
      ],
      "settings": {},
      "version": "<string>"
    },
    "deleted": "<boolean>",
    "elasticsearch": {
      "blacklist": ["<string>", "<string>"],
      "capacity_constraints": { "max": "<integer>", "min": "<integer>" },
      "compatible_node_types": ["<string>", "<string>"],
      "default_plugins": ["<string>", "<string>"],
      "docker_image": "<string>",
      "node_types": [
        {
          "capacity_constraints": { "max": "<integer>", "min": "<integer>" },
          "compatible_node_types": ["<string>", "<string>"],
          "description": "<string>",
          "mandatory": "<boolean>",
          "name": "<string>",
          "node_type": "<string>",
          "settings": {}
        },
        {
          "capacity_constraints": { "max": "<integer>", "min": "<integer>" },
          "compatible_node_types": ["<string>", "<string>"],
          "description": "<string>",
          "mandatory": "<boolean>",
          "name": "<string>",
          "node_type": "<string>",
          "settings": {}
        }
      ],
      "plugins": ["<string>", "<string>"],
      "settings": {}
    },
    "kibana": {
      "blacklist": ["<string>", "<string>"],
      "capacity_constraints": { "max": "<integer>", "min": "<integer>" },
      "compatible_node_types": ["<string>", "<string>"],
      "docker_image": "<string>",
      "settings": {},
      "version": "<string>"
    },
    "metadata": {
      "min_index_compatibility_version": "<string>",
      "min_platform_version": "<string>",
      "min_wire_compatibility_version": "<string>",
      "notes": "<string>",
      "pre_release": "<boolean>",
      "schema_version": "<integer>"
    },
    "min_upgradable_from": "<string>",
    "template": {
      "hashes": [
        { "hash": "<string>", "path": "<string>" },
        { "hash": "<string>", "path": "<string>" }
      ],
      "template_version": "<string>"
    },
    "upgradable_to": ["<string>", "<string>"],
    "version": "<string>",
    "whitelisted": "<boolean>"
  },
  {
    "accessible": "<boolean>",
    "apm": {
      "blacklist": ["<string>", "<string>"],
      "capacity_constraints": { "max": "<integer>", "min": "<integer>" },
      "compatible_node_types": ["<string>", "<string>"],
      "docker_image": "<string>",
      "settings": {},
      "version": "<string>"
    },
    "appsearch": {
      "blacklist": ["<string>", "<string>"],
      "capacity_constraints": { "max": "<integer>", "min": "<integer>" },
      "compatible_node_types": ["<string>", "<string>"],
      "docker_image": "<string>",
      "node_types": [
        {
          "capacity_constraints": { "max": "<integer>", "min": "<integer>" },
          "compatible_node_types": ["<string>", "<string>"],
          "description": "<string>",
          "mandatory": "<boolean>",
          "name": "<string>",
          "node_type": "<string>",
          "settings": {}
        },
        {
          "capacity_constraints": { "max": "<integer>", "min": "<integer>" },
          "compatible_node_types": ["<string>", "<string>"],
          "description": "<string>",
          "mandatory": "<boolean>",
          "name": "<string>",
          "node_type": "<string>",
          "settings": {}
        }
      ],
      "settings": {},
      "version": "<string>"
    },
    "deleted": "<boolean>",
    "elasticsearch": {
      "blacklist": ["<string>", "<string>"],
      "capacity_constraints": { "max": "<integer>", "min": "<integer>" },
      "compatible_node_types": ["<string>", "<string>"],
      "default_plugins": ["<string>", "<string>"],
      "docker_image": "<string>",
      "node_types": [
        {
          "capacity_constraints": { "max": "<integer>", "min": "<integer>" },
          "compatible_node_types": ["<string>", "<string>"],
          "description": "<string>",
          "mandatory": "<boolean>",
          "name": "<string>",
          "node_type": "<string>",
          "settings": {}
        },
        {
          "capacity_constraints": { "max": "<integer>", "min": "<integer>" },
          "compatible_node_types": ["<string>", "<string>"],
          "description": "<string>",
          "mandatory": "<boolean>",
          "name": "<string>",
          "node_type": "<string>",
          "settings": {}
        }
      ],
      "plugins": ["<string>", "<string>"],
      "settings": {}
    },
    "kibana": {
      "blacklist": ["<string>", "<string>"],
      "capacity_constraints": { "max": "<integer>", "min": "<integer>" },
      "compatible_node_types": ["<string>", "<string>"],
      "docker_image": "<string>",
      "settings": {},
      "version": "<string>"
    },
    "metadata": {
      "min_index_compatibility_version": "<string>",
      "min_platform_version": "<string>",
      "min_wire_compatibility_version": "<string>",
      "notes": "<string>",
      "pre_release": "<boolean>",
      "schema_version": "<integer>"
    },
    "min_upgradable_from": "<string>",
    "template": {
      "hashes": [
        { "hash": "<string>", "path": "<string>" },
        { "hash": "<string>", "path": "<string>" }
      ],
      "template_version": "<string>"
    },
    "upgradable_to": ["<string>", "<string>"],
    "version": "<string>",
    "whitelisted": "<boolean>"
  }
]
⌘I