<a id="hook-command-status-get"></a>

# `status-get`

## Summary

Prints status information.

## Usage

```text
status-get [options] [--include-data] [--application]
```

### Options

| Flag             | Default   | Usage                                                                       |
|------------------|-----------|-----------------------------------------------------------------------------|
| `--application`  | false     | Prints status for all units of this application if this unit is the leader. |
| `--format`       | smart     | Specify output format (json|smart|yaml)                                     |
| `--include-data` | false     | Prints all status data.                                                     |
| `-o`, `--output` |           | Specify an output file                                                      |

## Examples

```none
# Access the unit’s status:
status-get
status-get --include-data

# Access the application’s status:
status-get --application
```

## Details

`status-get` allows charms to query the current workload status.

Without arguments, it just prints the status code e.g. ‘maintenance’.
With `--include-data` specified, it prints YAML which contains the status
value plus any data associated with the status.

Include the `--application` option to get the overall status for the application,
rather than an individual unit.