---
title: "Kv Get"
method: POST
path: "/api/v1.kv.get"
tags: ["Key Value Store"]
---

# Kv Get

`POST /api/v1.kv.get`

KV Get

## Request body

- KvGetIn
  - `namespace` string, nullable
  - `key` string, required
  - `consistency` 'strong' | 'weak' — Consistency level for reads. Strong consistency (also known as linearizability) guarantees that a read will see all previous writes. Weak consistency allows stale reads, but can save one or more round trip to the leader.

## Response `200`

- KvGetOut
  - `expiry` integer, nullable — Time of expiry
  - `value` integer[], nullable
  - `version` integer, required — Opaque version token for optimistic concurrency control. Pass as `version` in a subsequent `set` to perform a conditional write.

## Other responses

- `400`
- `401`
- `403`
- `422`

---

[API](https://skmtc.net/svix/apis/diom-api.md) · [All operations](https://skmtc.net/svix/apis/diom-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/svix/diom-api/versions/e98d7f3a3e10/schema)
