anchor.diff:  [[search-field-caps]]
   === Field Capabilities API
   
  -The field capabilities API allows to retrieve the capabilities of fields among multiple indices.
  -
  -The field capabilities API by default executes on all indices:
  +Allows you to retrieve the capabilities of fields among multiple indices.
   
   [source,console]
   --------------------------------------------------
  -GET _field_caps?fields=rating
  +GET /_field_caps?fields=rating
   --------------------------------------------------
   
  -The request can also be restricted to specific indices:
  +
  +[[search-field-caps-api-request]]
  +==== {api-request-title}
  +
  +`GET /_field_caps` 
  +
  +`POST /_field_caps` 
  +
  +`GET /<index>/_field_caps` 
  +
  +`POST /<index>/_field_caps`
  +
  +
  +[[search-field-caps-api-desc]]
  +==== {api-description-title}
  +
  +
  +The field capabilities API returns the information about the capabilities of 
  +fields among multiple indices.
  +
  +
  +[[search-field-caps-api-path-params]]
  +==== {api-path-parms-title}
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=index]
  +
  +
  +[[search-field-caps-api-query-params]]
  +==== {api-query-parms-title}
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=allow-no-indices]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=expand-wildcards]
  ++
  +--
  +Defaults to `open`.
  +--
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=fields]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=index-ignore-unavailable]
  +
  +`include_unmapped`::
  +  (Optional, boolean) If `true`, unmapped fields are included in the response. 
  +  Defaults to `false`.
  +
  +
  +[[search-field-caps-api-response-body]]
  +==== {api-response-body-title}
  +  
  +
  +
  +`searchable`::
  +  Whether this field is indexed for search on all indices.
  +
  +`aggregatable`::
  +  Whether this field can be aggregated on all indices.
  +
  +`indices`::
  +  The list of indices where this field has the same type, or null if all indices 
  +  have the same type for the field.
  +
  +`non_searchable_indices`::
  +  The list of indices where this field is not searchable, or null if all indices 
  +  have the same definition for the field.
  +
  +`non_aggregatable_indices`::
  +  The list of indices where this field is not aggregatable, or null if all 
  +  indices have the same definition for the field.
  +
  +
  +[[search-field-caps-api-example]]
  +==== {api-examples-title}
  +
  +
  +The request can be restricted to specific indices:
   
   [source,console]
   --------------------------------------------------
  
positive.code:     }
  }
  --------------------------------------------------
  // NOTCONSOLE
  
  <1> The `rating` field is unmapped` in `index5`.
  <2> The `title` field is unmapped` in `index5`.
  
negative.code: --------------------------------------------------
  // TEST[setup:twitter]
  
  
  The next example API call requests information about the `rating` and the 
  `title` fields:
  
  [source,console]
  --------------------------------------------------
  GET _field_caps?fields=rating,title
  --------------------------------------------------
  
  The API returns the following response:
  
  [source,console-result]
  --------------------------------------------------
  {
      "indices": ["index1", "index2", "index3", "index4", "index5"],
  