---
title: stack es snapshot status cli command
description: Get the snapshot status. Behaviour flags: --dry-run — validate all inputs and exit without performing any action 
url: https://www.elastic.co/elastic/docs-builder/docs/4089/reference/elastic-cli/cli/stack/es/snapshot/status
applies_to:
  - Elastic Cloud Serverless: Preview
  - Elastic Stack: Preview
---

# stack es snapshot status cli command
<cli-modifiers>
</cli-modifiers>

```bash
elastic stack es snapshot status [options]
```

Get the snapshot status.
**Behaviour flags:**
`--dry-run` — validate all inputs and exit without performing any action

## Options

<definitions>
  <definition term="--ignore-unavailable">
    If `false`, the request returns an error for any snapshots that are unavailable.
    If `true`, the request ignores snapshots that are unavailable, such as those that are corrupted or temporarily cannot be returned.
  </definition>
  <definition term="--master-timeout string">
    The period to wait for the master node.
    If the master node is not available before the timeout expires, the request fails and returns an error.
    To indicate that the request should never timeout, set it to `-1`.
  </definition>
  <definition term="--repository string">
    The snapshot repository name used to limit the request.
    It supports wildcards (`*`) if `<snapshot>` isn't specified.
  </definition>
  <definition term="--snapshot string">
    A comma-separated list of snapshots to retrieve status for.
    The default is currently running snapshots.
    Wildcards (`*`) are not supported.
    **Repeatable:** pass `--snapshot` multiple times to supply more than one value
  </definition>
  <definition term="--error-trace">
    When set to `true` Elasticsearch will include the full stack trace of errors
    when they occur.
  </definition>
  <definition term="--filter-path string">
    Comma-separated list of filters in dot notation which reduce the response
    returned by Elasticsearch.
    **Repeatable:** pass `--filter-path` multiple times to supply more than one value
  </definition>
  <definition term="--human">
    When set to `true` will return statistics in a format suitable for humans.
    For example `"exists_time": "1h"` for humans and
    `"exists_time_in_millis": 3600000` for computers. When disabled the human
    readable values will be omitted. This makes sense for responses being consumed
    only by machines.
  </definition>
  <definition term="--pretty">
    If set to `true` the returned JSON will be "pretty-formatted". Only use
    this option for debugging only.
  </definition>
  <definition term="--input-file string">
    path to a JSON file to use as command input
  </definition>
  <definition term="--dry-run">
    validate all inputs and exit without performing any action (preview changes without applying them)
  </definition>
</definitions>


## Global Options

<definitions>
  <definition term="--json">
    output as JSON
  </definition>
</definitions>