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. -
all_shards boolean
If
true
, the validation is executed on all shards instead of one random shard per index. -
analyzer string
Analyzer to use for the query string. This parameter can only be used when the
q
query string parameter is specified. -
analyze_wildcard boolean
If
true
, wildcard and prefix queries are analyzed. -
default_operator string
The default operator for query string query:
AND
orOR
.Values are
and
,AND
,or
, orOR
. -
df string
Field to use as default where no field prefix is given in the query string. This parameter can only be used when the
q
query string parameter is specified. -
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 returns detailed information if an error has occurred. -
lenient boolean
If
true
, format-based query failures (such as providing text to a numeric field) in the query string will be ignored. -
rewrite boolean
If
true
, returns a more detailed explanation showing the actual Lucene query that will be executed. -
q string
Query in the Lucene query string syntax.
curl \
-X GET http://api.example.com/_validate/query \
-H "Content-Type: application/json" \
-d '{"query":{}}'
{
"query": {}
}
{
"explanations": [
{
"error": "string",
"explanation": "string",
"index": "string",
"valid": true
}
],
"_shards": {
"failed": 42.0,
"successful": 42.0,
"total": 42.0,
"failures": [
{
"index": "string",
"node": "string",
"reason": {
"type": "string",
"reason": "string",
"stack_trace": "string",
"caused_by": {},
"root_cause": [
{}
],
"suppressed": [
{}
]
},
"shard": 42.0,
"status": "string"
}
],
"skipped": 42.0
},
"valid": true,
"error": "string"
}