OpenSearch/docs/reference/cat/count.asciidoc

[[cat-count]]
=== cat count API
++++
<titleabbrev>cat count</titleabbrev>
++++

Provides quick access to a document count of individual indices or all indices
in a cluster.

NOTE: The document count only includes live documents, not deleted documents
which have not yet been removed by the merge process.


[[cat-count-api-request]]
==== {api-request-title}

`GET /_cat/count/<index>`

`GET /_cat/count`


[[cat-count-api-path-params]]
==== {api-path-parms-title}

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


[[cat-count-api-query-params]]
==== {api-query-parms-title}

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

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

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

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

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


[[cat-count-api-example]]
==== {api-examples-title}

[[cat-count-api-example-ind]]
===== Example with an individual index

The following `count` API request retrieves the document count of a single
index, `twitter`.

[source,console]
--------------------------------------------------
GET /_cat/count/twitter?v
--------------------------------------------------
// TEST[setup:big_twitter]


The API returns the following response:

[source,txt]
--------------------------------------------------
epoch      timestamp count
1475868259 15:24:20  120
--------------------------------------------------
// TESTRESPONSE[s/1475868259 15:24:20/\\d+ \\d+:\\d+:\\d+/ non_json]

[[cat-count-api-example-all]]
===== Example with all indices in a cluster

The following `count` API request retrieves the document count of all indices in
the cluster.

[source,console]
--------------------------------------------------
GET /_cat/count?v
--------------------------------------------------
// TEST[setup:big_twitter]
// TEST[s/^/POST test\/test\?refresh\n{"test": "test"}\n/]

The API returns the following response:

[source,txt]
--------------------------------------------------
epoch      timestamp count
1475868259 15:24:20  121
--------------------------------------------------
// TESTRESPONSE[s/1475868259 15:24:20/\\d+ \\d+:\\d+:\\d+/ non_json]