Fetch test run items

Fetch one page of ClickHouse test_items_wide rows for a v1 test run, keyset-paginated by example_id. Defaults to the first 200 items when no pagination params are given; pass next_cursor back as cursor to fetch the next page.

GET/v1/projects/{projectId}/test-runs/{testRunId}/items

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

testRunIdstringrequired

Query parameters

limitnumber

Max items to return per page (default and max 200).

min 1 · max 200

cursorstring

Keyset cursor: the next_cursor (example_id) returned by the previous page.

Responses

200

Response for status 200

resultsobject[]required

Show properties

Array of object

organization_idstringrequired

project_idstringrequired

test_run_idstringrequired

dataset_idstringrequired

dataset_version_idstringrequired

example_idstringrequired

agent_offline_trace_idstring | nullrequired

Show properties

Any of:

string

string

null

null

created_atstringrequired

exampleobject | nullrequired

Show properties

Any of:

object

example_idstringrequired

organization_idstring

project_idstring

dataobjectrequired

metadataobject | null

Show properties

Any of:

object

object

null

null

managed_metadataobjectrequired

created_atstring

user_idstringrequired

null

null

dataobjectrequired

scorersobject[]required

Show properties

Array of object

judge_idstringrequired

judge_namestring | nullrequired

Show properties

Any of:

string

string

null

null

judge_major_versionnumberrequired

judge_minor_versionnumberrequired

score_typestringrequired

num_valuenumberrequired

bool_valuebooleanrequired

str_valuestringrequired

reasonanyrequired

metadataanyrequired

successboolean | nullrequired

Show properties

Any of:

boolean

boolean

null

null

errorstring | nullrequired

Show properties

Any of:

string

string

null

null

created_atstringrequired

has_morebooleanrequired

Whether more items exist beyond this page.

next_cursorstring | nullrequired

Show properties

Any of:

string

string

null

null

ui_results_urlstring | null

Show properties

Any of:

string

string

null

null

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*testRunIdpath*limitqueryMax items to return per page (default and max 200).cursorqueryKeyset cursor: the next_cursor (example_id) returned by the previous page.

Request

curl -X GET 'https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/test-runs/YOUR_TEST_RUN_ID/items' \
  -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/test-runs/YOUR_TEST_RUN_ID/items", {
  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/test-runs/YOUR_TEST_RUN_ID/items",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "X-Organization-Id": "YOUR_ORGANIZATION_ID",
        "Accept": "application/json"
    },
)

Response

{
  "results": [
    {
      "organization_id": "string",
      "project_id": "string",
      "test_run_id": "string",
      "dataset_id": "string",
      "dataset_version_id": "string",
      "example_id": "string",
      "agent_offline_trace_id": "string",
      "created_at": "string",
      "example": {
        "example_id": "string",
        "organization_id": "string",
        "project_id": "string",
        "data": {},
        "metadata": {},
        "managed_metadata": {},
        "created_at": "string",
        "user_id": "string"
      },
      "data": {},
      "scorers": [
        {
          "judge_id": "string",
          "judge_name": "string",
          "judge_major_version": 0,
          "judge_minor_version": 0,
          "score_type": "string",
          "num_value": 0,
          "bool_value": true,
          "str_value": "string",
          "reason": null,
          "metadata": null,
          "success": true,
          "error": "string",
          "created_at": "string"
        }
      ]
    }
  ],
  "has_more": true,
  "next_cursor": "string",
  "ui_results_url": "string"
}