Sample - OpenAI API
GET/evals/{eval_id}/runs/{run_id}

Get an evaluation run

Retrieves a single evaluation run by its identifier within an evaluation. Use eval_id and run_id together to inspect the run's status, report URL, result counts, model usage, and testing-criteria results.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
eval_idstringrequired
The unique identifier of the evaluation containing the run.
run_idstringrequired
The unique identifier of the evaluation run to retrieve.

2 status codes
200Returns the evaluation run with its identifier, status, model, creation timestamp, report URL, result counts, model usage, testing-criteria results, data source, metadata, and error information.
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_usagearray<object>required
Usage statistics for each model during the evaluation run.
per_testing_criteria_resultsarray<object>required
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.
429Returned when the request is rejected because the rate limit has been exceeded.
errorobjectrequired

Error handling

eval_id must identify the evaluation containing the run, and run_id must identify the run to retrieve. A 429 is returned when the request is rejected because the rate limit has been exceeded.