---
title: stack es msearch cli command
description: Run multiple searches. Behaviour flags: --dry-run — validate all inputs and exit without performing any action 
url: https://www.elastic.co/elastic/docs-builder/docs/4083/reference/elastic-cli/cli/stack/es/msearch
applies_to:
  - Elastic Cloud Serverless: Preview
  - Elastic Stack: Preview
---

# stack es msearch cli command
<cli-modifiers>
</cli-modifiers>

```bash
elastic stack es msearch [options]
```

Run multiple searches.
**Behaviour flags:**
`--dry-run` — validate all inputs and exit without performing any action

## Options

<definitions>
  <definition term="--allow-no-indices">
    A setting that does two separate checks on the index expression.
    If `false`, the request returns an error (1) if any wildcard expression
    (including `_all` and `*`) resolves to zero matching indices or (2) if the
    complete set of resolved indices, aliases or data streams is empty after all
    expressions are evaluated. If `true`, index expressions that resolve to no
    indices are allowed and the request returns an empty result.
  </definition>
  <definition term="--ccs-minimize-roundtrips">
    If true, network roundtrips between the coordinating node and remote clusters are minimized for cross-cluster search requests.
  </definition>
  <definition term="--expand-wildcards enum">
    Type of index that wildcard expressions can match. If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.
    **Values:** all, open, closed, hidden, none
    **Repeatable:** pass `--expand-wildcards` multiple times to supply more than one value
  </definition>
  <definition term="--ignore-throttled">
    If true, concrete, expanded or aliased indices are ignored when frozen.
  </definition>
  <definition term="--ignore-unavailable">
    If `false`, the request returns an error if it targets a concrete (non-wildcarded)
    index, alias, or data stream that is missing, closed, or otherwise unavailable.
    If `true`, unavailable concrete targets are silently ignored.
  </definition>
  <definition term="--include-named-queries-score">
    Indicates whether hit.matched_queries should be rendered as a map that includes
    the name of the matched query associated with its score (true)
    or as an array containing the name of the matched queries (false)
    This functionality reruns each named query on every hit in a search response.
    Typically, this adds a small overhead to a request.
    However, using computationally expensive named queries on a large number of hits may add significant overhead.
  </definition>
  <definition term="--index string">
    Comma-separated list of data streams, indices, and index aliases to search.
    **Repeatable:** pass `--index` multiple times to supply more than one value
  </definition>
  <definition term="--max-concurrent-searches number">
    Maximum number of concurrent searches the multi search API can execute.
    Defaults to `max(1, (# of data nodes * min(search thread pool size, 10)))`.
  </definition>
  <definition term="--max-concurrent-shard-requests number">
    Maximum number of concurrent shard requests that each sub-search request executes per node.
  </definition>
  <definition term="--pre-filter-shard-size number">
    Defines a threshold that enforces a pre-filter roundtrip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter roundtrip can limit the number of shards significantly if for instance a shard can not match any documents based on its rewrite method i.e., if date filters are mandatory to match but the shard bounds and the query are disjoint.
  </definition>
  <definition term="--rest-total-hits-as-int">
    If true, hits.total are returned as an integer in the response. Defaults to false, which returns an object.
  </definition>
  <definition term="--routing string">
    Custom routing value used to route search operations to a specific shard.
    Not allowed when `index.slice.enabled` is `true` for the target index; use `_slice` instead.
    **Repeatable:** pass `--routing` multiple times to supply more than one value
  </definition>
  <definition term="--search-type enum">
    Indicates whether global term and document frequencies should be used when scoring returned documents.
    **Values:** query_then_fetch, dfs_query_then_fetch
  </definition>
  <definition term="--typed-keys">
    Specifies whether aggregation and suggester names should be prefixed by their respective types in the response.
  </definition>
  <definition term="--searches string[]">
    **Repeatable:** pass `--searches` multiple times to supply more than one value
  </definition>
  <definition term="--error-trace">
    When set to `true` Elasticsearch will include the full stack trace of errors
    when they occur.
  </definition>
  <definition term="--filter-path string">
    Comma-separated list of filters in dot notation which reduce the response
    returned by Elasticsearch.
    **Repeatable:** pass `--filter-path` multiple times to supply more than one value
  </definition>
  <definition term="--human">
    When set to `true` will return statistics in a format suitable for humans.
    For example `"exists_time": "1h"` for humans and
    `"exists_time_in_millis": 3600000` for computers. When disabled the human
    readable values will be omitted. This makes sense for responses being consumed
    only by machines.
  </definition>
  <definition term="--pretty">
    If set to `true` the returned JSON will be "pretty-formatted". Only use
    this option for debugging only.
  </definition>
  <definition term="--input-file string">
    path to a JSON file to use as command input
  </definition>
  <definition term="--dry-run">
    validate all inputs and exit without performing any action (preview changes without applying them)
  </definition>
</definitions>


## Global Options

<definitions>
  <definition term="--json">
    output as JSON
  </definition>
</definitions>