Get many in KV

Reads up to 1000 keys at once (MGET).

Checked 2026-09-28

Reads up to 1000 keys at once (MGET). Answers one entry per key, in order; an absent or expired key keeps its key and has no value.

Path POST https://api.data.sylphx.com/v1/kv-mget
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.
`keys`	`string[]`	The keys, at most 1000. Required.

#Response

Field	Type	What it is
`values`	`ValueRecord[]`	One entry per key, in the order asked; an absent or expired key keeps its key and has no `value` or `version`.

#ValueRecord

Field	Type	What it is
`namespace_id`	`string`	The namespace's id in the environment, for example `ratelimit`.
`key`	`string`	The key.
`value`	`bytes`	The bytes, base64.
`sha256`	`string`	`sha256:<hex>` of the value.
`version`	`uint64`	The version, increasing per key.
`expires_at_unix_ms`	`int64`	Expiry in Unix milliseconds; zero never expires.
`updated_at_unix_ms`	`int64`	When this version was written, in Unix milliseconds.

#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-mget" \
  -H "Authorization: Bearer $SYLPHX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["…"],"namespace_id":"…"}'

Was this page helpful?

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

Send feedback

Platform links