elasticsearch/docs/reference/indices/get-index-template.asciidoc

[[indices-get-template]]
=== Get index template API [[getting-templates]]
++++
<titleabbrev>Get index template</titleabbrev>
++++

Returns information about one or more index templates.

////

[source,console]
--------------------------------------------------
PUT /_index_template/template_1
{
  "index_patterns" : ["te*"],
  "priority" : 1,
  "template": {
    "settings" : {
      "number_of_shards" : 2
    }
  }
}
--------------------------------------------------
// TESTSETUP

[source,console]
--------------------------------------------------
DELETE _index_template/template_*
--------------------------------------------------
// TEARDOWN

////

[source,console]
--------------------------------------------------
GET /_index_template/template_1
--------------------------------------------------

[[get-template-api-request]]
==== {api-request-title}

`GET /_index_template/<index-template>`

[[get-template-api-prereqs]]
==== {api-prereq-title}

* If the {es} {security-features} are enabled, you must have the
`manage_index_templates` or `manage` <<privileges-list-cluster,cluster
privilege>> to use this API.

[[get-template-api-path-params]]
==== {api-path-parms-title}

(Optional, string) The name of the template to return. Accepts wildcard
expressions. If omitted, all templates are returned.

[[get-template-api-query-params]]
==== {api-query-parms-title}

include::{docdir}/rest-api/common-parms.asciidoc[tag=flat-settings]

include::{docdir}/rest-api/common-parms.asciidoc[tag=local]

include::{docdir}/rest-api/common-parms.asciidoc[tag=master-timeout]

`include_defaults`::
(Optional, Boolean) Functionality in preview:[]. If `true`, return all default settings in the response.
Defaults to `false`.

[[get-template-api-example]]
==== {api-examples-title}


[[get-template-api-wildcard-ex]]
===== Get index templates using a wildcard expression

[source,console]
--------------------------------------------------
GET /_index_template/temp*
--------------------------------------------------


[[get-template-api-all-ex]]
===== Get all index templates

[source,console]
--------------------------------------------------
GET /_index_template
--------------------------------------------------