IMPORTANT: This documentation is no longer updated. Refer to Elastic's version policy and the latest documentation.

IDs

edit

Returns documents based on their IDs. This query uses document IDs stored in the _id field.

Example request

edit
GET /_search
{
    "query": {
        "ids" : {
            "values" : ["1", "4", "100"]
        }
    }
}

Top-level parameters for ids

edit
values
(Required, array of strings) An array of document IDs.