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.


To send a query request to PPL plugin, use the HTTP POST request. We recommend a POST request because it doesn’t have any length limit and it allows you to pass other parameters to the plugin for other functionality.

Use the explain endpoint for query translation and troubleshooting.

Request Format

To use the PPL plugin with your own applications, send requests to _opendistro/_ppl, with your query in the request body:

curl -H 'Content-Type: application/json' -X POST localhost:9200/_opendistro/_ppl \
... -d '{"query" : "source=accounts | fields firstname, lastname"}'