4e064cf81dae

latestOpenAPI 3.1.02026-08-131831,331960.0 KB
experiments

Get experiment score histogram with filters

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

post/api/v2/experiments/{experiment_id}/histogram/

Path parameters

experiment_idstring required

Experiment ID returned as id in experiment responses.

Query parameters

evaluator_idstring required

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

binsinteger

Number of histogram bins for numerical scores. Maximum 50.

Headers

Authorizationstring required

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.

Response

Experiment score histogram.

evaluator_idstring required
evaluator_slugstring nullable
evaluator_namestring nullable