---
title: "ZRANGEBYSCORE"
url: "https://docs.yugabyte.com/stable/yedis/api/zrangebyscore/"
---

# ZRANGEBYSCORE

## Synopsis

**`ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count]`**

This command fetches `members` for which `score` is in the given `min` `max` range. `min` and `max` are doubles. If `key` does not exist, an empty range is returned. If `key` corresponds to a non sorted-set, an error is raised. Special bounds `-inf` and `+inf` are also supported to retrieve an entire range. `min` and `max` are inclusive unless they are prefixed with `(`, in which case they are exclusive.

## Return value

Returns a list of `members` found in the range specified by `min`, `max`, unless the WITHSCORES option is specified (see below).

## ZRANGEBYSCORE options

- WITHSCORES: Makes the command return both the `member` and its `score`.
- LIMIT offset count: Get a range of the matching elements starting at `offset` up to `count` elements, where `offset` is 0 indexed.

## Examples

You can do this as shown below.

```sh
$ ZADD z_key 1.0 v1 2.0 v2
```

```
(integer) 2
```

Retrieve all members.

```sh
$ ZRANGEBYSCORE z_key -inf +inf
```

```
1) "v1"
2) "v2"
```

Retrieve all member score pairs.

```sh
$ ZRANGEBYSCORE z_key -inf +inf WITHSCORES
```

```
1) "v1"
2) "1.0"
3) "v2"
4) "2.0"
```

Bounds are inclusive.

```sh
$ ZRANGEBYSCORE z_key 1.0 2.0
```

```
1) "v1"
2) "v2"
```

Bounds are exclusive.

```sh
$ ZRANGEBYSCORE z_key (1.0 (2.0
```

```
(empty list or set)
```

Enforce a limit.

```sh
ZRANGEBYSCORE z_key -inf +inf LIMIT 1 1
```

```
1) "v2"
```

## See also

[`zadd`](/stable/yedis/api/zadd/ "zadd"), [`zcard`](/stable/yedis/api/zcard/ "zcard"), [`zrange`](/stable/yedis/api/zrange/ "zrange"), [`zrem`](/stable/yedis/api/zrem/ "zrem"), [`zrevrange`](/stable/yedis/api/zrevrange "zrevrange")