Link Search Menu Expand Document

The Open Distro project is archived. Open Distro development has moved to OpenSearch. The Open Distro plugins will continue to work with legacy versions of Elasticsearch OSS, but we recommend upgrading to OpenSearch to take advantage of the latest features and improvements.

Common REST parameters

Elasticsearch supports the following parameters for all REST operations:

Option Description Example
Human-readable output To convert output units to human-readable values (for example, 1h for 1 hour and 1kb for 1,024 bytes), add ?human=true to the request URL. GET <index_name>/_search?human=true
Pretty result To get back JSON responses in a readable format, add ?pretty=true to the request URL. GET <index_name>/_search?pretty=true
Content type To specify the type of content in the request body, use the Content-Type key name in the request header. Most operations support JSON, YAML, and CBOR formats. POST _scripts/<template_name> -H 'Content-Type: application/json
Request body in query string If the client library does not accept a request body for non-POST requests, use the source query string parameter to pass the request body. Also, specify the source_content_type parameter with a supported media type such as application/json. GET _search?source_content_type=application/json&source={"query":{"match_all":{}}}
Stack traces To include the error stack trace in the response when an exception is raised, add error_trace=true to the request URL. GET <index_name>/_search?error_trace=true