Zset range in KV

Reads a range of a sorted set by rank, lowest score first (ZRANGE); negative indexes count from the end.

Checked 2026-09-28

Reads a range of a sorted set by rank, lowest score first (ZRANGE); negative indexes count from the end.

Path POST https://api.data.sylphx.com/v1/kv-zset-ranges
Scope data:read
Effect read — nothing is written.
Collection kv
Host https://api.data.sylphx.com

#Request

Field	Type	What it is
`namespace_id`	`string`	The namespace's id. Required.
`key`	`string`	The sorted set's key. Required.
`start`	`int64`	The first rank, inclusive; unset is 0, negative counts from the end.
`stop`	`int64`	The last rank, inclusive; unset is -1 (the end).
`with_scores`	`bool`	Whether to answer each member's score.

#Response

Field	Type	What it is
`members`	`ZSetMember[]`	The members in the range, lowest score first.

#ZSetMember

Field	Type	What it is
`member`	`string`	The member. Required.
`score`	`double`	The score; unset in a range read without `with_scores`.

#Errors

UNAUTHENTICATED — No valid key or token was presented.
PERMISSION_DENIED — The key lacks the method's permission.
INVALID_FIELD — A field failed validation.
RESOURCE_NOT_FOUND — The named Resource does not exist or is not visible.

Every error arrives in the body Errors describes.

#Examples

curl -X POST "https://api.data.sylphx.com/v1/kv-zset-ranges" \
  -H "Authorization: Bearer $SYLPHX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key":"…","namespace_id":"…"}'

Was this page helpful?

Tell us what is missing, wrong, or unclear — this opens a real inbox.

Send feedback

Platform links