# Get cluster-wide settings

**GET /_cluster/settings**

By default, it returns only settings that have been explicitly defined.

## Required authorization

* Cluster privileges: `monitor`


[More about Elastic Stack settings](https://www.elastic.co/docs/deploy-manage/stack-settings)

## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Api key auth
- Basic auth
- Bearer auth


## Parameters


### Query parameters
- **flat_settings** (boolean)
  If `true`, returns settings in flat format.
- **include_defaults** (boolean)
  If `true`, also returns default values for all other cluster settings, reflecting the values
  in the `elasticsearch.yml` file of one of the nodes in the cluster. If the nodes in your
  cluster do not all have the same values in their `elasticsearch.yml` config files then the
  values returned by this API may vary from invocation to invocation and may not reflect the
  values that Elasticsearch uses in all situations. Use the `GET _nodes/settings` API to
  fetch the settings for each individual node in your cluster.
- **master_timeout** (string)
  Period to wait for a connection to the master node.
  If no response is received before the timeout expires, the request fails and returns an error.
- **timeout** (string)
  Period to wait for a response.
  If no response is received before the timeout expires, the request fails and returns an error.


## Responses
### 200


#### Body: application/json (object)
- **persistent** (object)
  The settings that persist after the cluster restarts.
- **transient** (object)
  The settings that do not persist after the cluster restarts.
- **defaults** (object)
  The default setting values.


[Powered by Bump.sh](https://bump.sh)