# Get field data cache information


**GET /_cat/fielddata/{fields}**

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

<div>
                      <span class="operation-verb get">GET</span>
                      <span class="operation-path">/_cat/fielddata</span>
                      </div>
                    <div>
                      <span class="operation-verb get">GET</span>
                      <span class="operation-path">/_cat/fielddata/{fields}</span>
                      </div>
                    

Get the amount of heap memory currently used by the field data cache on every data node in the cluster.

IMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console.
They are not intended for use by applications. For application consumption, use the nodes stats API.

## Required authorization

* Cluster privileges: `monitor`



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


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


## Parameters

### Path parameters
- **fields** (string | array[string])
  Comma-separated list of fields used to limit returned information.
  To retrieve all fields, omit this parameter.

### Query parameters
- **fields** (string | array[string])
  Comma-separated list of fields used to limit returned information.
- **h** (string | array[string])
  A comma-separated list of columns names to display. It supports simple wildcards.

  Supported values include:
    - `id`: The node ID.
    - `host` (or `h`): The host name of the node.
    - `ip`: The IP address of the node.
    - `node` (or `n`): The node name.
    - `field` (or `f`): The field name.
    - `size` (or `s`): The field data usage.

- **s** (string | array[string])
  List of columns that determine how the table should be sorted.
  Sorting defaults to ascending and can be changed by setting `:asc`
  or `:desc` as a suffix to the column name.


## Responses
### 200


#### Body: application/json (array[object])
- **id** (string)
  node id
- **host** (string)
  host name
- **ip** (string)
  ip address
- **node** (string)
  node name
- **field** (string)
  field name
- **size** (string)
  field data usage


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