[[query-dsl-ids-query]]
=== Ids Query

Filters documents that only have the provided ids. Note, this query
uses the <<mapping-id-field,_id>> field.

[source,js]
--------------------------------------------------
GET /_search
{
    "query": {
        "ids" : {
            "type" : "_doc",
            "values" : ["1", "4", "100"]
        }
    }
}    
--------------------------------------------------
// CONSOLE

The `type` is optional and can be omitted, and can also accept an array
of values. If no type is specified, all types defined in the index mapping are tried.
