Query Judgments
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": "sarah@acme.com" },
"createdAt": 1731432000000,
"organizationId": "org_eu",
"documentId": "doc_42",
"agent": null
}
],
"total": 37
}
}
Query Judgments
POST
/
v2
/
memory
/
judgments
/
query
Query Judgments
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": "sarah@acme.com" },
"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
string
required
Your API key.
string
required
Your Auth Token.
Body
Params
object
required
Show properties
Show properties
string
Narrow to one organization.
string
Narrow to one document. Requires
organizationId.string
Filter by decision value, e.g.
approve or reject.string
human or agent.string
Filter by the reviewed content type.
string
Filter by the deciding user.
string
When set, returns the judgments for that one comment thread. Requires
organizationId.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": "sarah@acme.com" },
"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": "sarah@acme.com" },
"createdAt": 1731432000000,
"organizationId": "org_eu",
"documentId": "doc_42",
"agent": null
}
],
"total": 37
}
}
Was this page helpful?
⌘I

