{ "id": "ts.mget", "title": "TS.MGET", "url": "https://redis.io/docs/latest/commands/ts.mget/", "summary": "Get the sample with the highest timestamp from each time series matching a specific filter", "tags": [ "docs", "develop", "stack", "oss", "rs", "rc", "oss", "kubernetes", "clients" ], "last_updated": "2026-04-09T10:29:34-04:00", "page_type": "content", "content_hash": "7c8f9203616d85a2c828827059f59e3aff922db6f1e7503149f6597ee56cdae7", "sections": [ { "id": "overview", "title": "Overview", "role": "overview", "text": "This command's behavior varies in clustered Redis environments. See the [multi-key operations]() page for more information.\n\n\n\n\nGet the sample with the highest timestamp from each time series matching a specific filter. Starting from Redis 8.6, NaN values are included in the results.\n\n\nThis command will reply only if the current user has read access to all keys that match the filter.\nOtherwise, it will reply with \"*(error): current user doesn't have read permission to one or more keys that match the specified filter*\".\n\n\n[Examples](#examples)" }, { "id": "required-arguments", "title": "Required arguments", "role": "content", "text": "
\nFILTER filterExpr...\n\nfilters time series based on their labels and label values. Each filter expression has one of the following syntaxes:\n\n - `label!=` - the time series has a label named `label`\n - `label=value` - the time series has a label named `label` with a value equal to `value`\n - `label=(value1,value2,...)` - the time series has a label named `label` with a value equal to one of the values in the list\n - `label=` - the time series does not have a label named `label`\n - `label!=value` - the time series does not have a label named `label` with a value equal to `value`\n - `label!=(value1,value2,...)` - the time series does not have a label named `label` with a value equal to any of the values in the list\n\n Notes:\n - At least one filter expression with a syntax `label=value` or `label=(value1,value2,...)` is required.\n - Filter expressions are conjunctive. For example, the filter `type=temperature room=study` means that a time series is a temperature time series of a study room.\n - Whitespaces are unallowed in a filter expression except between quotes or double quotes in values - e.g., `x=\"y y\"` or `x='(y y,z z)'`.\n \n
" }, { "id": "optional-arguments", "title": "Optional arguments", "role": "parameters", "text": "
\nLATEST (since RedisTimeSeries v1.8) \n\nis used when a time series is a compaction. With `LATEST`, TS.MGET also reports the compacted value of the latest (possibly partial) bucket, given that this bucket's start time falls within `[fromTimestamp, toTimestamp]`. Without `LATEST`, TS.MGET does not report the latest (possibly partial) bucket. When a time series is not a compaction, `LATEST` is ignored.\n \nThe data in the latest bucket of a compaction is possibly partial. A bucket is _closed_ and compacted only upon the arrival of a new sample that _opens_ a new _latest_ bucket. There are cases, however, when the compacted value of the latest (possibly partial) bucket is also required. In such a case, use `LATEST`.\n
\n\n
\nWITHLABELS \n\nincludes in the reply all label-value pairs representing metadata labels of the time series. \nIf `WITHLABELS` or `SELECTED_LABELS` are not specified, by default, an empty list is reported as label-value pairs.\n\n
\n\n
\nSELECTED_LABELS label... (since RedisTimeSeries v1.6) \n\nreturns a subset of the label-value pairs that represent metadata labels of the time series. \nUse when a large number of labels exists per series, but only the values of some of the labels are required. \nIf `WITHLABELS` or `SELECTED_LABELS` are not specified, by default, an empty list is reported as label-value pairs.\n\n
\n\nNote: The [`MGET`]() command cannot be part of a transaction when running on a Redis cluster." }, { "id": "examples", "title": "Examples", "role": "example", "text": "
\nSelect labels to retrieve\n\nCreate time series for temperature in Tel Aviv and Jerusalem, then add different temperature samples.\n\n\n127.0.0.1:6379> TS.CREATE temp:TLV LABELS type temp location TLV\nOK\n127.0.0.1:6379> TS.CREATE temp:JLM LABELS type temp location JLM\nOK\n127.0.0.1:6379> TS.MADD temp:TLV 1000 30 temp:TLV 1010 35 temp:TLV 1020 9999 temp:TLV 1030 40\n1) (integer) 1000\n2) (integer) 1010\n3) (integer) 1020\n4) (integer) 1030\n127.0.0.1:6379> TS.MADD temp:JLM 1005 30 temp:JLM 1015 35 temp:JLM 1025 9999 temp:JLM 1035 40\n1) (integer) 1005\n2) (integer) 1015\n3) (integer) 1025\n4) (integer) 1035\n\n\nGet all the labels associated with the last sample.\n\n\n127.0.0.1:6379> TS.MGET WITHLABELS FILTER type=temp\n1) 1) \"temp:JLM\"\n 2) 1) 1) \"type\"\n 2) \"temp\"\n 2) 1) \"location\"\n 2) \"JLM\"\n 3) 1) (integer) 1035\n 2) 40\n2) 1) \"temp:TLV\"\n 2) 1) 1) \"type\"\n 2) \"temp\"\n 2) 1) \"location\"\n 2) \"TLV\"\n 3) 1) (integer) 1030\n 2) 40\n\n\nTo get only the `location` label for each last sample, use `SELECTED_LABELS`.\n\n\n127.0.0.1:6379> TS.MGET SELECTED_LABELS location FILTER type=temp\n1) 1) \"temp:JLM\"\n 2) 1) 1) \"location\"\n 2) \"JLM\"\n 3) 1) (integer) 1035\n 2) 40\n2) 1) \"temp:TLV\"\n 2) 1) 1) \"location\"\n 2) \"TLV\"\n 3) 1) (integer) 1030\n 2) 40\n\n
" }, { "id": "redis-software-and-redis-cloud-compatibility", "title": "Redis Software and Redis Cloud compatibility", "role": "content", "text": "| Redis
Software | Redis
Cloud | Notes |\n|:----------------------|:-----------------|:------|\n| ✅ Supported
| ✅ Flexible & Annual
✅ Free & Fixed | |" }, { "id": "return-information", "title": "Return information", "role": "returns", "text": "**RESP2:**\n\n[Array reply](): for each time series matching the specified filters, the following is reported:\n- [Bulk string reply](): The time series key name\n- [Array reply](): label-value pairs ([Bulk string reply](), [Bulk string reply]())\n - By default, an empty array is reported\n - If `WITHLABELS` is specified, all labels associated with this time series are reported\n - If `SELECTED_LABELS label...` is specified, the selected labels are reported (null value when no such label defined)\n- [Array reply](): a single timestamp-value pair ([Integer reply](), [Simple string reply]())\n\n**RESP3:**\n\n[Map reply](): for each time series matching the specified filters, the following is reported:\n- [Bulk string reply](): The time series key name\n- [Map reply]() or [Array reply](): label-value pairs\n - By default, an empty array is reported\n - If `WITHLABELS` is specified, all labels associated with this time series are reported as a map\n - If `SELECTED_LABELS label...` is specified, the selected labels are reported as a map (null value when no such label defined)\n- [Array reply](): a single timestamp-value pair ([Integer reply](), [Double reply]())" }, { "id": "see-also", "title": "See also", "role": "related", "text": "[`TS.MRANGE`]() | [`TS.RANGE`]() | [`TS.MREVRANGE`]() | [`TS.REVRANGE`]()" }, { "id": "related-topics", "title": "Related topics", "role": "related", "text": "[RedisTimeSeries]()" } ], "examples": [] }