List experiment results

curl --request GET \
  --url https://api.example.com/v3/evals/experiments/{experiment_id}/results \
  --header 'Authorization: Bearer <token>'

{
  "api_version": "3.0",
  "kind": "PAGINATED",
  "data": {
    "page_size": 10,
    "item_count": 10,
    "total": 100,
    "page_count": 10,
    "page_index": 1,
    "offset": 0,
    "experiment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "dataset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "items": [
      {
        "experiment_item_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "dataset_item_id": "<string>",
        "inputs": {},
        "outputs": {},
        "expected_outputs": {},
        "scores": [
          {
            "score_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "evaluator_name": "<string>",
            "score_name": "<string>",
            "score_label": "<string>",
            "score_value": 123,
            "reasoning": "<string>",
            "error_reason": "<string>",
            "error_message": "<string>"
          }
        ],
        "error_reason": "<string>",
        "error_message": "<string>"
      }
    ]
  }
}

Experiments

List experiment results

Get a paginated list of results for an experiment. Each result contains the experiment item outputs, dataset inputs and expected outputs, and all associated evaluation scores (including the evaluator name). Filtering (filter parameter — JSON-encoded QueryCondition DSL): - experiment_item_id — filter by one or more item IDs (operators: equal, not_equal, in, not_in)

Ordering (ordering parameter): - timestamp / -timestamp — sort by item timestamp (default: -timestamp) - created_at / -created_at — sort by backend creation time - scores.score_value / -scores.score_value — sort by first score value - scores.{score_name} / -scores.{score_name} — sort by named score value (e.g. scores.accuracy, -scores.toxicity)

GET

evals

experiments

{experiment_id}

results

List experiment results

curl --request GET \
  --url https://api.example.com/v3/evals/experiments/{experiment_id}/results \
  --header 'Authorization: Bearer <token>'

{
  "api_version": "3.0",
  "kind": "PAGINATED",
  "data": {
    "page_size": 10,
    "item_count": 10,
    "total": 100,
    "page_count": 10,
    "page_index": 1,
    "offset": 0,
    "experiment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "dataset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "items": [
      {
        "experiment_item_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "dataset_item_id": "<string>",
        "inputs": {},
        "outputs": {},
        "expected_outputs": {},
        "scores": [
          {
            "score_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "evaluator_name": "<string>",
            "score_name": "<string>",
            "score_label": "<string>",
            "score_value": 123,
            "reasoning": "<string>",
            "error_reason": "<string>",
            "error_message": "<string>"
          }
        ],
        "error_reason": "<string>",
        "error_message": "<string>"
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

experiment_id

string<uuid>

required

Path parameter for unique identifier of an experiment

Query Parameters

filter

string

Allows you to filter by any field.

ordering

string

Allows you to order results by any field. For desc order prefix field name with - and provide comman separated values for multiple fields

limit

integer

Limit for the pagination

offset

integer

Offset for the pagination

Response

List of results for an experiment

Response object for paginated API responses.

api_version

enum<string>

default:3.0

API version of the response.

Available options:

2.0,

3.0

kind

enum<string>

default:PAGINATED

Type of response, indicating a paginated response.

Available options:

PAGINATED

data

object

Show child attributes

getEvalScores

List experiments

⌘I