Query memory judgments (v2)

Query Memory reviewer judgments by filters such as outcome, reviewer, or time range using the Velt v2 REST API to analyze decisions and approval trends.

POST /v2/memory/judgments/query

Query Judgments

cURL

curl --request POST \
  --url https://api.velt.dev/v2/memory/judgments/query \
  --header 'Content-Type: application/json' \
  --header 'x-velt-api-key: <x-velt-api-key>' \
  --header 'x-velt-auth-token: <x-velt-auth-token>' \
  --data '
{
  "data": {
    "organizationId": "<string>",
    "documentId": "<string>",
    "decision": "<string>",
    "judgeType": "<string>",
    "contentType": "<string>",
    "reviewerId": "<string>",
    "annotationId": "<string>",
    "limit": 123
  }
}
'

import requests

url = "https://api.velt.dev/v2/memory/judgments/query"

payload = { "data": {
        "organizationId": "<string>",
        "documentId": "<string>",
        "decision": "<string>",
        "judgeType": "<string>",
        "contentType": "<string>",
        "reviewerId": "<string>",
        "annotationId": "<string>",
        "limit": 123
    } }
headers = {
    "x-velt-api-key": "<x-velt-api-key>",
    "x-velt-auth-token": "<x-velt-auth-token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-velt-api-key': '<x-velt-api-key>',
    'x-velt-auth-token': '<x-velt-auth-token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    data: {
      organizationId: '<string>',
      documentId: '<string>',
      decision: '<string>',
      judgeType: '<string>',
      contentType: '<string>',
      reviewerId: '<string>',
      annotationId: '<string>',
      limit: 123
    }
  })
};

fetch('https://api.velt.dev/v2/memory/judgments/query', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.velt.dev/v2/memory/judgments/query",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'data' => [
        'organizationId' => '<string>',
        'documentId' => '<string>',
        'decision' => '<string>',
        'judgeType' => '<string>',
        'contentType' => '<string>',
        'reviewerId' => '<string>',
        'annotationId' => '<string>',
        'limit' => 123
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-velt-api-key: <x-velt-api-key>",
    "x-velt-auth-token: <x-velt-auth-token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.velt.dev/v2/memory/judgments/query"

	payload := strings.NewReader("{\n  \"data\": {\n    \"organizationId\": \"<string>\",\n    \"documentId\": \"<string>\",\n    \"decision\": \"<string>\",\n    \"judgeType\": \"<string>\",\n    \"contentType\": \"<string>\",\n    \"reviewerId\": \"<string>\",\n    \"annotationId\": \"<string>\",\n    \"limit\": 123\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-velt-api-key", "<x-velt-api-key>")
	req.Header.Add("x-velt-auth-token", "<x-velt-auth-token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.velt.dev/v2/memory/judgments/query")
  .header("x-velt-api-key", "<x-velt-api-key>")
  .header("x-velt-auth-token", "<x-velt-auth-token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"data\": {\n    \"organizationId\": \"<string>\",\n    \"documentId\": \"<string>\",\n    \"decision\": \"<string>\",\n    \"judgeType\": \"<string>\",\n    \"contentType\": \"<string>\",\n    \"reviewerId\": \"<string>\",\n    \"annotationId\": \"<string>\",\n    \"limit\": 123\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.velt.dev/v2/memory/judgments/query")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-velt-api-key"] = '<x-velt-api-key>'
request["x-velt-auth-token"] = '<x-velt-auth-token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"data\": {\n    \"organizationId\": \"<string>\",\n    \"documentId\": \"<string>\",\n    \"decision\": \"<string>\",\n    \"judgeType\": \"<string>\",\n    \"contentType\": \"<string>\",\n    \"reviewerId\": \"<string>\",\n    \"annotationId\": \"<string>\",\n    \"limit\": 123\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "result": {
    "results": [
      {
        "recordId": "act_8f3...",
        "reasoning": "Approved after fixing the citation.",
        "decision": "approve",
        "confidence": 0.81,
        "judgeType": "human",
        "contentType": "marketing-copy",
        "actionUser": { "userId": "u_sarah", "name": "Sarah Lee", "email": "[e-mail]" },
        "createdAt": 1731432000000,
        "organizationId": "org_eu",
        "documentId": "doc_42",
        "agent": null
      }
    ],
    "total": 37
  }
}

Use this API to list judgments by metadata only, with no semantic search. Use it when you want to enumerate decisions by decision value, reviewer, content type, or thread instead of ranking by similarity.

Endpoint

POST https://api.velt.dev/v2/memory/judgments/query

Headers

x-velt-api-key · string · required

Your API key.

x-velt-auth-token · string · required

Your Auth Token.

Body

Params

data · object · required

Show properties

organizationId · string

Narrow to one organization.

documentId · string

Narrow to one document. Requires organizationId.

decision · string

Filter by decision value, e.g. approve or reject.

judgeType · string

human or agent.

contentType · string

Filter by the reviewed content type.

reviewerId · string

Filter by the deciding user.

annotationId · string

When set, returns the judgments for that one comment thread. Requires organizationId.

limit · integer

1 to 100. Defaults to 20.

Example Requests

List a reviewer’s rejections

{
  "data": {
    "decision": "reject",
    "reviewerId": "u_sarah",
    "limit": 20
  }
}

Response

Each record includes the reasoning, decision, confidence, judgeType, contentType, who decided (actionUser), timestamps, and scope ids. An agent block is present when an AI agent decided. total reports the match count.

Success Response

{
  "result": {
    "results": [
      {
        "recordId": "act_8f3...",
        "reasoning": "Approved after fixing the citation.",
        "decision": "approve",
        "confidence": 0.81,
        "judgeType": "human",
        "contentType": "marketing-copy",
        "actionUser": { "userId": "u_sarah", "name": "Sarah Lee", "email": "[e-mail]" },
        "createdAt": 1731432000000,
        "organizationId": "org_eu",
        "documentId": "doc_42",
        "agent": null
      }
    ],
    "total": 37
  }
}

Failure Response

{
  "error": {
    "message": "ERROR_MESSAGE",
    "status": "INVALID_ARGUMENT"
  }
}

{
  "result": {
    "results": [
      {
        "recordId": "act_8f3...",
        "reasoning": "Approved after fixing the citation.",
        "decision": "approve",
        "confidence": 0.81,
        "judgeType": "human",
        "contentType": "marketing-copy",
        "actionUser": { "userId": "u_sarah", "name": "Sarah Lee", "email": "[e-mail]" },
        "createdAt": 1731432000000,
        "organizationId": "org_eu",
        "documentId": "doc_42",
        "agent": null
      }
    ],
    "total": 37
  }
}