Get a document count

GET /_cat/count

Get quick access to a document count for a data stream, an index, or an entire cluster. The document count only includes live documents, not deleted documents which have not yet been removed by the merge process.

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 count API.

Responses

200

application/json

application/json text/plain
Hide response attributes Show response attributes object
- epoch number | string
  
  Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
  
  Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
  
  One of:
  _types:UnitSeconds number _spec_utils:StringifiedEpochTimeUnitSeconds string
  
  Time unit for seconds
- timestamp string
  
  Time of day, expressed as HH:MM:SS
- count string
  
  the document count

GET /_cat/count

curl \
 --request GET http://api.example.com/_cat/count \
 --header "Authorization: $API_KEY"

Response examples (200)

[
  {
    "": 42.0,
    "timestamp": "string",
    "count": "string"
  }
]

Response examples (200)

A successful response from `GET /_cat/count/my-index-000001?v=true`. It retrieves the document count for the `my-index-000001` data stream or index.

epoch      timestamp count
1475868259 15:24:20  120

A successful response from `GET /_cat/count?v=true`. It retrieves the document count for all data streams and indices in the cluster.

epoch      timestamp count
1475868259 15:24:20  121

Get a document count

Responses

epoch number | string