You're viewing version 1.0 of the OpenSearch documentation. This version is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.
Get document
Introduced 1.0
After adding a JSON document to your index, you can use the get document API operation to retrieve the document’s information and data.
Example
GET sample-index1/_doc/1
Path and HTTP methods
GET <index>/_doc/<_id>
HEAD <index>/_doc/<_id>
GET <index>/_source/<_id>
HEAD <index>/_source/<_id>
URL parameters
All get document URL parameters are optional.
| Parameter | Type | Description |
|---|---|---|
| preference | String | Specifies a preference of which shard to retrieve results from. Available options are _local, which tells the operation to retrieve results from a locally allocated shard replica, and a custom string value assigned to a specific shard replica. By default, OpenSearch executes get document operations on random shards. |
| realtime | Boolean | Specifies whether the operation should run in realtime. If false, the operation waits for the index to refresh to analyze the source to retrieve data, which makes the operation near-realtime. Default is true. |
| refresh | Boolean | If true, OpenSearch refreshes shards to make the get operation available to search results. Valid options are true, false, and wait_for, which tells OpenSearch to wait for a refresh before executing the operation. Default is false. |
| routing | String | A value used to route the operation to a specific shard. |
| stored_fields | Boolean | Whether the get operation should retrieve fields stored in the index. Default is false. |
| _source | String | Whether to include the _source field in the response body. Default is true. |
| _source_excludes | String | A comma-separated list of source fields to exclude in the query response. |
| _source_includes | String | A comma-separated list of source fields to include in the query response. |
| version | Integer | The version of the document to return, which must match the current version of the document. |
| version_type | Enum | Retrieves a specifically typed document. Available options are external (retrieve the document if the specified version number is greater than the document’s current version) and external_gte (retrieve the document if the specified version number is greater than or equal to the document’s current version). For example, to retrieve version 3 of a document, use /_doc/1?version=3&version_type=external. |
Response
{
"_index": "sample-index1",
"_type": "_doc",
"_id": "1",
"_version": 1,
"_seq_no": 0,
"_primary_term": 9,
"found": true,
"_source": {
"text": "This is just some sample text."
}
}
Response body fields
| Field | Description |
|---|---|
| _index | The name of the index. |
| _type | The document’s type. OpenSearch only supports one type, which is _doc. |
| _id | The document’s ID. |
| _version | The document’s version number. Updated whenever the document changes. |
| _seq_no | The sequnce number assigned when the document is indexed. |
| primary_term | The primary term assigned when the document is indexed. |
| found | Whether the document exists. |
| _routing | The shard that the document is routed to. If the document is not routed to a particular shard, this field is omitted. |
| _source | Contains the document’s data if found is true. If _source is set to false or stored_fields is set to true in the URL parameters, this field is omitted. |
| _fields | Contains the document’s data that’s stored in the index. Only returned if both stored_fields and found are true. |