Skip to main content
POST
/
v2
/
memory
/
profiles
/
get
Get Reviewer Profile
curl --request POST \
  --url https://api.velt.dev/v2/memory/profiles/get \
  --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": {
    "targetUserId": "<string>"
  }
}
'
{
  "result": {
    "userId": "u_sarah",
    "name": "Sarah Lee",
    "email": "sarah@acme.com",
    "totalJudgments": 214,
    "approvalRate": 0.62,
    "avgReviewTimeSeconds": 87,
    "topFlags": [ { "issue": "missing-citation", "count": 31 } ],
    "contentTypes": ["marketing-copy"],
    "peakHours": [9, 10, 14],
    "orgBreakdown": {
      "org_eu": {
        "organizationId": "org_eu",
        "clientOrganizationId": null,
        "judgments": 120,
        "approvals": 70,
        "approvalRate": 0.58
      }
    },
    "lastActive": 1731432000000
  }
}
Use this API to fetch a reviewer’s behavioral profile: judgment volume, approval rate, review speed, top flags, content types, peak hours, and a per-organization breakdown. Profiles are derived from accumulated judgments, so they need some review history before they are meaningful.

Endpoint

POST https://api.velt.dev/v2/memory/profiles/get

Headers

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

Body

Params

data
object
required

Example Requests

Get a specific reviewer’s profile

{
  "data": {
    "targetUserId": "u_sarah"
  }
}

Response

The result is a reviewer profile, or null when no profile exists yet.

Success Response

{
  "result": {
    "userId": "u_sarah",
    "name": "Sarah Lee",
    "email": "sarah@acme.com",
    "totalJudgments": 214,
    "approvalRate": 0.62,
    "avgReviewTimeSeconds": 87,
    "topFlags": [ { "issue": "missing-citation", "count": 31 } ],
    "contentTypes": ["marketing-copy"],
    "peakHours": [9, 10, 14],
    "orgBreakdown": {
      "org_eu": {
        "organizationId": "org_eu",
        "clientOrganizationId": null,
        "judgments": 120,
        "approvals": 70,
        "approvalRate": 0.58
      }
    },
    "lastActive": 1731432000000
  }
}

Failure Response

{
  "error": {
    "message": "ERROR_MESSAGE",
    "status": "INVALID_ARGUMENT"
  }
}
{
  "result": {
    "userId": "u_sarah",
    "name": "Sarah Lee",
    "email": "sarah@acme.com",
    "totalJudgments": 214,
    "approvalRate": 0.62,
    "avgReviewTimeSeconds": 87,
    "topFlags": [ { "issue": "missing-citation", "count": 31 } ],
    "contentTypes": ["marketing-copy"],
    "peakHours": [9, 10, 14],
    "orgBreakdown": {
      "org_eu": {
        "organizationId": "org_eu",
        "clientOrganizationId": null,
        "judgments": 120,
        "approvals": 70,
        "approvalRate": 0.58
      }
    },
    "lastActive": 1731432000000
  }
}