This version of the OpenSearch documentation is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.

IDs query

Use the ids query to search for documents with one or more specific document ID values in the _id field. For example, the following query requests documents with the IDs 34229 and 91296:

  1. GET shakespeare/_search
  2. {
  3.   "query": {
  4.     "ids": {
  5.       "values": [
  6.         34229,
  7.         91296
  8.       ]
  9.     }
  10.   }
  11. }

copy

Parameters

The query accepts the following parameter.

ParameterData typeDescription
valuesArray of stringsThe document IDs to search for. Required.