Get index information

GET /_cat/indices/{index}
GET /_cat/indices

Get high-level information about indices in a cluster, including backing indices for data streams.

Use this request to get the following information for each index in a cluster:

shard count
document count
deleted document count
primary store size
total store size of all shards, including shard replicas

These metrics are retrieved directly from Lucene, which Elasticsearch uses internally to power indexing and search. As a result, all document counts include hidden nested documents. To get an accurate count of Elasticsearch documents, use the cat count or count APIs.

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 an index endpoint.

Required authorization

Index privileges: monitor
Cluster privileges: monitor

Path Parameters

index union IndexName | [] IndexName optional

Comma-separated list of data streams, indices, and aliases used to limit the request. Supports wildcards (*). To target all data streams and indices, omit this parameter or use * or _all.

Leave it out to use /_cat/indices.

Query Parameters

expand_wildcards string ExpandWildcards · default: all

The type of index that wildcard patterns can match.

Supported values include:

all: Match any data stream or index, including hidden ones.
open: Match open, non-hidden indices. Also matches any non-hidden data stream.
closed: Match closed, non-hidden indices. Also matches any non-hidden data stream. Data streams cannot be closed.
hidden: Match hidden data streams and hidden indices. Must be combined with open, closed, or both.
none: Wildcard expressions are not accepted.

Values: all open closed hidden none

health enum HealthStatus

The health status used to limit returned indices. By default, the response includes indices of any health status.

Supported values include:

green (or GREEN): All shards are assigned.
yellow (or YELLOW): All primary shards are assigned, but one or more replica shards are unassigned. If a node in the cluster fails, some data could be unavailable until that node is repaired.
red (or RED): One or more primary shards are unassigned, so some data is unavailable. This can occur briefly during cluster startup as primary shards are assigned.
unknown
unavailable

Values: green GREEN yellow YELLOW red RED unknown unavailable

include_unloaded_segments boolean · default: false

If true, the response includes information from segments that are not loaded into memory.

pri boolean · default: false

If true, the response only includes information from primary shards.

master_timeout string Duration · default: 30s

Period to wait for a connection to the master node.

h union Names

List of columns to appear in the response. Supports simple wildcards.

One of: Name or Name[]

s union Names

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.

One of: Name or Name[]

Response

application/json

Examples

A successful response from GET /_cat/indices/my-index-*?v=true&s=index&format=json.

Request Console 1 / 7 languages

Console Kibana Dev Tools

GET /_cat/indices/my-index-*?v=true&s=index&format=json

JavaScript Elasticsearch JavaScript Client

const response = await client.cat.indices({
  index: "my-index-*",
  v: "true",
  s: "index",
  format: "json",
});

Python Elasticsearch Python Client

resp = client.cat.indices(
    index="my-index-*",
    v=True,
    s="index",
    format="json",
)

curl Shell

curl -X GET "$ELASTICSEARCH_URL/_cat/indices/my-index-*?v=true&s=index&format=json" \
  -H "Authorization: ApiKey $ELASTIC_API_KEY"

Java Elasticsearch Java Client

client.cat().indices();

PHP Elasticsearch PHP Client

$resp = $client->cat()->indices([
    "index" => "my-index-*",
    "v" => "true",
    "s" => "index",
    "format" => "json",
]);

Ruby Elasticsearch Ruby Client

response = client.cat.indices(
  index: "my-index-*",
  v: "true",
  s: "index",
  format: "json"
)

Response

[
  {
    "health": "yellow",
    "status": "open",
    "index": "my-index-000001",
    "uuid": "u8FNjxh8Rfy_awN11oDKYQ",
    "pri": "1",
    "rep": "1",
    "docs.count": "1200",
    "docs.deleted": "0",
    "store.size": "88.1kb",
    "pri.store.size": "88.1kb",
    "dataset.size": "88.1kb"
  },
  {
    "health": "green",
    "status": "open",
    "index": "my-index-000002",
    "uuid": "nYFWZEO7TUiOjLQXBaYJpA ",
    "pri": "1",
    "rep": "0",
    "docs.count": "0",
    "docs.deleted": "0",
    "store.size": "260b",
    "pri.store.size": "260b",
    "dataset.size": "260b"
  }
]

Required authorization

Path Parameters

Query Parameters { expand_wildcards , health , include_unloaded_segments , pri , master_timeout , h , s , }

Response

Query Parameters