# TS.LIST

> List time series names, optionally only those with a given label value.

URL: https://docs.hotkv.com/commands/ts-list/

```
TS.LIST [LABEL label value]
```

- Group: Time series
- Complexity: O(N), N being the series on the node
- HotKV Cloud: Performance and Scale plans
- On-Premise: requires the time-series license feature

`TS.LIST` returns the names of all time series on the node, in no particular
order. With `LABEL label value`, it returns only the series whose label
`label` equals `value`; an empty `value` (`""`) matches any series that has
the label at all.

In cluster mode, the command lists the series of the node you send it to.

## Return value

| Case | RESP2 | RESP3 |
| --- | --- | --- |
| Always | Array of series names (empty when none match) | Same |

Error replies: `NOLICENSE ...` without the `time-series` license feature.

## Examples

```
127.0.0.1:6379> TS.CREATE temp:kitchen LABELS room kitchen
OK
127.0.0.1:6379> TS.CREATE temp:hall LABELS room hall
OK
127.0.0.1:6379> TS.LIST LABEL room kitchen
1) "temp:kitchen"
127.0.0.1:6379> TS.LIST
1) "temp:hall"
2) "temp:kitchen"
```

The order of names in the full list can differ.

## Compatibility

HotKV-only command. RedisTimeSeries finds series by label with
`TS.QUERYINDEX`.

## See also

[TS.CREATE](https://docs.hotkv.com/commands/ts-create/index.md), [TS.INFO](https://docs.hotkv.com/commands/ts-info/index.md)