Get judge label

Get analytics for one enabled production judge label, including its label rate, eligible denominator, last-applied time, and time series. For binary judges, true means the judge applied its label, which the app shows under the judge’s name. false means no label was applied. For classification judges, the value is the label, meaning the chosen option.

GET/v1/projects/{projectId}/behaviors/{behaviorId}/analytics

Authorization

AuthorizationPersonal API key · headerrequired

Your personal API key from Settings > Personal API Keys, sent as Bearer <key>.

X-Organization-IdOrganization ID · headerrequired

The organization to act in. Copy it with Copy organization ID in the organization menu or the settings sidebar.

Path parameters

projectIdstringrequired

behaviorIdstring<uuid>required

Label ID

matches ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Query parameters

start_datestring

Start date (ISO 8601)

end_datestring

End date (ISO 8601)

Responses

200

Response for status 200

start_timestring | nullrequired

end_timestringrequired

granularitystringrequired

Allowed:1m5m30m1h6h12h1d

dataobject[]required

Show properties

Array of object

judge_idstringrequired

behavior_idstringrequired

timestampstringrequired

countstringrequired

summariesobject[]required

Show properties

Array of object

judge_idstringrequired

behavior_idstringrequired

trace_countstringrequired

judge_trace_countstringrequired

distribution_ratenumber | nullrequired

last_seen_atstring | nullrequired

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Personal API keyOrganization IDRemember on this deviceInclude my values in samples

Parameters

projectIdpath*behaviorIdpath*Label IDstart_datequeryStart date (ISO 8601)end_datequeryEnd date (ISO 8601)

Request

curl -X GET 'https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/behaviors/YOUR_BEHAVIOR_ID/analytics' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'X-Organization-Id: YOUR_ORGANIZATION_ID' \
  -H 'Accept: application/json'

const response = await fetch("https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/behaviors/YOUR_BEHAVIOR_ID/analytics", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "X-Organization-Id": "YOUR_ORGANIZATION_ID",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/behaviors/YOUR_BEHAVIOR_ID/analytics",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "X-Organization-Id": "YOUR_ORGANIZATION_ID",
        "Accept": "application/json"
    },
)

Response

{
  "start_time": "string",
  "end_time": "string",
  "granularity": "1m",
  "data": [
    {
      "judge_id": "string",
      "behavior_id": "string",
      "timestamp": "string",
      "count": "string"
    }
  ],
  "summaries": [
    {
      "judge_id": "string",
      "behavior_id": "string",
      "trace_count": "string",
      "judge_trace_count": "string",
      "distribution_rate": 0,
      "last_seen_at": "string"
    }
  ]
}