Skip to main content
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
  }
}
'
{
  "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

​
x-velt-api-key
string
required
Your API key.
​
x-velt-auth-token
string
required
Your Auth Token.

​
Body

​
Params

​
data
object
required

​
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
  }
}