# 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 the values of all other cluster settings set in the
  `elasticsearch.yml` file on one of the nodes in your cluster, together with the default
  values of all other cluster settings on that node. The default value of each setting may
  depend on the values of other settings on that node. If the nodes in your cluster do not all
  have the same configuration 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)