Get experiment score histogram with filters

POST

https://api.respan.ai/api/v2/experiments/:experiment_id/histogram/

Compute histogram aggregation for experiment evaluation scores. The backend reads evaluator_id and bins from query parameters; it does not consume a request body.

Authentication

AuthorizationBearer

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

AuthorizationBearer

Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.

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.

Response

Experiment score histogram.

evaluator_idstring

binslist of objects

statsobject

evaluator_slugstring or nullOptional

evaluator_namestring or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error