OpenAI API (unofficial showcase)
GET/evals/{eval_id}/runs/{run_id}

Retrieve an evaluation run

Retrieves a specific run for an evaluation. Use this endpoint to inspect the run's status, results, report URL, and usage details after creating or canceling a run.

2 parameters
eval_idstringrequired
The identifier of the evaluation that owns the run.
run_idstringrequired
The identifier of the run to retrieve.

4 status codes
200Returns the evaluation run object, including its status, report URL, result counts, per-model usage, and testing criteria results.
objectstringrequired
The type of the object. Always "eval.run".
Allowed:eval.runDefault:eval.run
idstringrequired
Unique identifier for the evaluation run.
eval_idstringrequired
The identifier of the associated evaluation.
statusstringrequired
The status of the evaluation run.
modelstringrequired
The model that is evaluated, if applicable.
namestringrequired
The name of the evaluation run.
created_atintegerrequired
Unix timestamp (in seconds) when the evaluation run was created.
report_urlstringrequired
The URL to the rendered evaluation run report on the UI dashboard.
result_countsobjectrequired
Counters summarizing the outcomes of the evaluation run.
per_model_usagearrayrequired
Usage statistics for each model during the evaluation run.
per_testing_criteria_resultsarrayrequired
Results per testing criteria applied during the evaluation run.
data_sourceobjectrequired
Information about the run's data source.
metadataobjectrequired
Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard. Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters.
errorobjectrequired
An object representing an error response from the Eval API.
400Returned when the evaluation run does not belong to the specified evaluation.
errorobjectrequired
404Returned when the evaluation or evaluation run was not found.
errorobjectrequired
429Returned when the request is rejected because a rate limit was exceeded.
errorobjectrequired

Error handling

A 400 is returned when the run does not belong to the specified evaluation. A 404 is returned when the evaluation or run is not found. A 429 is returned when the request exceeds a rate limit. Both eval_id and run_id must identify the evaluation and its run.