elasticsearch/docs/reference/query-languages/query-dsl/query-dsl-ids-query.md

---

navigation_title: "IDs" mapped_pages:

• https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-ids-query.html ---

IDs [query-dsl-ids-query]

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

Example request [_example_request_3]

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

Top-level parameters for ids [ids-query-top-level-parameters]

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