Path parameters

• index string | array[string] Required

  Comma-separated list of data streams, indices, and aliases to search. Supports wildcards (*).

Query parameters

• allow_no_indices boolean

  If false, the request returns an error if any wildcard expression, index alias, or _all value targets only missing or closed indices. This behavior applies even if the request targets other open indices. For example, a request targeting foo*,bar* returns an error if an index starts with foo but no index starts with bar.

• ccs_minimize_roundtrips boolean

  If true, network round-trips are minimized for cross-cluster search requests.

• expand_wildcards string | array[string]

  Type of index that wildcard patterns can match. If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. Supports comma-separated values, such as open,hidden. Valid values are: all, open, closed, hidden, none.

• explain boolean

  If true, the response includes additional details about score computation as part of a hit.

• ignore_throttled boolean

  If true, specified concrete, expanded, or aliased indices are not included in the response when throttled.

• ignore_unavailable boolean

  If false, the request returns an error if it targets a missing or closed index.

• preference string

  Specifies the node or shard the operation should be performed on. Random by default.

• profile boolean

  If true, the query execution is profiled.

• routing string

  Custom value used to route operations to a specific shard.

• scroll string

  Specifies how long a consistent view of the index should be maintained for scrolled search.

• search_type string

  The type of the search operation.

  Values are query_then_fetch or dfs_query_then_fetch.

• rest_total_hits_as_int boolean

  If true, hits.total are rendered as an integer in the response.

• typed_keys boolean

  If true, the response prefixes aggregation and suggester names with their respective types.

Responses

• 200 application/json
  Hide response attributes Show response attributes object

  • took number Required
  • timed_out boolean Required
  • _shards object Required
    Hide _shards attributes Show _shards attributes object

    • failed number Required
    • successful number Required
    • total number Required
    • failures array[object]
      Hide failures attributes Show failures attributes object

      • index string
      • node string
      • reason object Required
        Hide reason attributes Show reason attributes object

        • type string Required

          The type of error

        • reason string

          A human-readable explanation of the error, in english

        • stack_trace string

          The server stack trace. Present only if the error_trace=true parameter was sent with the request.

        • caused_by object
        • root_cause array[object]
        • suppressed array[object]
      • shard number Required
      • status string
    • skipped number
  • hits object Required
    Hide hits attributes Show hits attributes object

    • total object | number

      Total hit count information, present only if track_total_hits wasn't false in the search request.

      One of:

      _types:TotalHits object number-2 number

      Hide attributes Show attributes

      • relation string Required

        Values are eq or gte.

      • value number Required
    • hits array[object] Required
      Hide hits attributes Show hits attributes object

      • _index string Required
      • _id string

      • _score number | string | null

        One of:

        number-1 number string-2 string | null
      • _explanation object
        Hide _explanation attributes Show _explanation attributes object

        • description string Required
        • details array[object] Required
        • value number Required
      • fields object
        Hide fields attributes Show fields attributes object

        • Additional properties
        • key object
      • highlight object
        Hide highlight attributes Show highlight attributes object

        • Additional properties
        • key array
      • inner_hits object
        Hide inner_hits attributes Show inner_hits attributes object

        • Additional properties
        • hits object Required

      • matched_queries array[string] | object

        One of:

        array-1 array[string] object-2 object

        Hide attributes Show attributes

        • Additional properties
        • key array
      • _nested object
        Hide _nested attributes Show _nested attributes object

        • field string Required

          Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.

        • offset number Required
        • _nested object
      • _ignored array[string]
      • ignored_field_values object
        Hide ignored_field_values attributes Show ignored_field_values attributes object

        • Additional properties
        • key array
      • _shard string
      • _node string
      • _routing string
      • _source object
      • _rank number
      • _seq_no number
      • _primary_term number
      • _version number
      • sort array[number | string | boolean | null | object]

        A field value.

        One of:

        _types:FieldValue number _types:FieldValue number _types:FieldValue string _types:FieldValue boolean _types:FieldValue string | null _types:FieldValue object

    • max_score number | string | null

      One of:

      number-1 number string-2 string | null
  • aggregations object
  • _clusters object
    Hide _clusters attributes Show _clusters attributes object

    • skipped number Required
    • successful number Required
    • total number Required
    • running number Required
    • partial number Required
    • failed number Required
    • details object
      Hide details attributes Show details attributes object

      • Additional properties
      • status string Required

        Values are running, successful, partial, skipped, or failed.

      • indices string Required
      • took number

        Time unit for milliseconds

      • timed_out boolean Required
      • _shards object
        Hide _shards attributes Show _shards attributes object

        • failed number Required
        • successful number Required
        • total number Required
        • failures array[object]
        • skipped number
      • failures array[object]
        Hide failures attributes Show failures attributes object

        • index string
        • node string
        • reason object Required
        • shard number Required
        • status string
  • fields object
    Hide fields attributes Show fields attributes object

    • Additional properties
    • key object
  • max_score number
  • num_reduce_phases number
  • profile object
    Hide profile attribute Show profile attribute object

    • shards array[object] Required
      Hide shards attributes Show shards attributes object

      • aggregations array[object] Required
        Hide aggregations attributes Show aggregations attributes object

        • breakdown object Required
        • description string Required
        • time_in_nanos
        • type string Required
        • debug object
        • children array[object]
      • id string Required
      • searches array[object] Required
        Hide searches attributes Show searches attributes object

        • collector array[object] Required
        • query array[object] Required
        • rewrite_time number Required
      • fetch object
        Hide fetch attributes Show fetch attributes object

        • type string Required
        • description string Required
        • time_in_nanos number

          Time unit for nanoseconds

        • breakdown object Required
          Hide breakdown attributes Show breakdown attributes object

          • load_source number
          • load_source_count number
          • load_stored_fields number
          • load_stored_fields_count number
          • next_reader number
          • next_reader_count number
          • process_count number
          • process number
        • debug object
          Hide debug attributes Show debug attributes object

          • stored_fields array[string]
          • fast_path number
        • children array[object]
  • pit_id string
  • _scroll_id string
  • suggest object
    Hide suggest attributes Show suggest attributes object

    • Additional properties
    • key array
  • terminated_early boolean