Get experiment score histogram with filters

curl -X POST "https://api.respan.ai/api/v2/experiments/experiment_id/histogram/?evaluator_id=eval_456" \
     -H "Authorization: Bearer sk_live_xxxxx" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "evaluator_id": "eval_789",
  "bins": [
    {
      "lower": 0,
      "upper": 0.2,
      "count": 15,
      "label": "Poor"
    },
    {
      "lower": 0.2,
      "upper": 0.4,
      "count": 30,
      "label": "Below Average"
    },
    {
      "lower": 0.4,
      "upper": 0.6,
      "count": 50,
      "label": "Average"
    },
    {
      "lower": 0.6,
      "upper": 0.8,
      "count": 70,
      "label": "Good"
    },
    {
      "lower": 0.8,
      "upper": 1,
      "count": 35,
      "label": "Excellent"
    }
  ],
  "stats": {
    "min": 0.05,
    "max": 0.98,
    "mean": 0.65,
    "total": 200
  },
  "evaluator_slug": "f1_score",
  "evaluator_name": "F1 Score Evaluator"
}

Return the same histogram response as GET. POST is accepted for consistency with dashboard views.

Path parameters

experiment_idstringRequired

Experiment ID returned as id in experiment responses.

Query parameters

evaluator_idstringRequired

Evaluator ID, optionally including a grader suffix such as eval_123:grader_name.

binsintegerOptional1-50Defaults to 20

Number of histogram bins for numerical scores. Maximum 50.

Request

This endpoint expects an object.

filtersobjectOptional

Filter criteria using the standard Respan filter format.

is_exportingbooleanOptionalDefaults to false

Reserved for dashboard exports.

Response

Experiment score histogram.

evaluator_idstring

binslist of objects

statsobject

evaluator_slugstring or null

evaluator_namestring or null

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

Path parameters

Headers

Query parameters

Request

Response

Errors