Valori LogoValori
GET/v1/records/{id}READ

Get a record

Fetches one record by id, decoded back to a float vector.

Returns the stored vector converted back to f32, plus whatever metadata was committed with it.

The vector is stored internally in Q16.16 fixed-point and converted back to f32 on the way out. Round-tripping is lossy at the fixed-point quantum — the returned vector will not be bit-identical to what you inserted, only equal to within that precision.

Parameters

idintegerrequired

Record id (path parameter).

collectionstringoptional

Collection the record belongs to (query parameter). Optional at the HTTP level — pass it explicitly.

Response fields

idintegerrequired

The record's id.

vectornumber[]required

The stored vector, decoded back to f32.

tagintegerrequired

The opaque numeric tag stored with the record, if any.

metadataobjectoptional

Whatever JSON was committed alongside the record, if any. null if none was set.

Errors

StatuscodeMeaning
401unauthorizedMissing or invalid API key.
403forbiddenThe key's scope doesn't include read_only.
404record_not_foundNo such record in this collection.

Related endpoints

GET /v1/records/{id}
curl "https://app.valori.systems/v1/records/42?collection=documents" \
  -H "Authorization: Bearer vlk_your_project_api_key"
200
{
  "id": 42,
  "vector": [0.12, 0.34, 0.56, 0.78, 0.11, 0.22, 0.33, 0.44],
  "tag": 0,
  "metadata": { "source": "handbook.pdf", "page": 3 }
}