# Get deprecation information


**GET /{index}/_migration/deprecations**

**All methods and paths for this operation:**

<div>
                      <span class="operation-verb get">GET</span>
                      <span class="operation-path">/_migration/deprecations</span>
                      </div>
                    <div>
                      <span class="operation-verb get">GET</span>
                      <span class="operation-path">/{index}/_migration/deprecations</span>
                      </div>
                    

Returns information about deprecated features which are in use in the cluster.
The reported features include cluster, node, and index level settings that will be removed or changed in the next major version.
You must address the reported issues before upgrading to the next major version.
However, no action is required when upgrading within the current major version.
Deprecated features remain fully supported and will continue to work in the current version, and when upgrading to a newer minor or patch release in the same major version.
Use this API to review your usage of these features and migrate away from them at your own pace, before upgrading to a new major version.

> info
> This API is designed for indirect use by the [Upgrade Assistant](https://www.elastic.co/docs/deploy-manage/upgrade/prepare-to-upgrade/upgrade-assistant).
> We recommend learning about deprecated features using the Upgrade Assistant rather than calling this API directly.

## Required authorization

* Cluster privileges: `manage`



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


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


## Parameters

### Path parameters
- **index** (string)
  Comma-separate list of data streams or indices to check. Wildcard (*) expressions are supported.



## Responses
### 200


#### Body: application/json (object)
- **cluster_settings** (array[object])
  Cluster-level deprecation warnings.
- **index_settings** (object)
  Index warnings are sectioned off per index and can be filtered using an index-pattern in the query.
  This section includes warnings for the backing indices of data streams specified in the request path.
- **data_streams** (object)

- **node_settings** (array[object])
  Node-level deprecation warnings.
  Since only a subset of your nodes might incorporate these settings, it is important to read the details section for more information about which nodes are affected.
- **ml_settings** (array[object])
  Machine learning-related deprecation warnings.
- **templates** (object)
  Template warnings are sectioned off per template and include deprecations for both component templates and
  index templates.
- **ilm_policies** (object)
  ILM policy warnings are sectioned off per policy.


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