Swagger Petstore - OpenAPI 3.0
GET/evals/{eval_id}/runs/{run_id}

Retrieve an evaluation run

Retrieves a specific evaluation run by its identifier. Returns the complete run details including status, model, results, usage statistics, and data source information. Use this to check run progress or inspect detailed results.

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

2 status codes
200Returns the evaluation run object with its identifier, status, model, name, creation timestamp, report URL, result counts, per-model usage statistics, per-testing-criteria results, data source information, and metadata.
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 rate limit is exceeded.
errorobjectrequired

Error handling

eval_id and run_id must both identify existing resources. A 429 is returned when the request rate limit is exceeded.