Skip to main content
GET
Get run evaluation
Returns just the assertion roll-up — equivalent to GET /agent-eval/runs/:id but trimmed to the evaluation field. Useful for CI checks where you only care about the score. The scoring fields aren’t final until the worker finishes both the conversation AND the assertion pass. Poll the parent GET /agent-eval/runs/:id until queue_status === "done", then call this endpoint. If you hit this endpoint while queue_status is still pending or claimed, score / pass_fail / results will be null.

Response shape

Authorizations

Authorization
string
header
required

Your Yappr API key (e.g. ypr_live_...). Generate one in the dashboard under Settings → API Keys.

Path Parameters

id
string<uuid>
required

Response

Evaluation result. Fields are null until the run is terminal.

Roll-up of assertion results that's also stored on eval_runs.evaluation.

score
number
required

Weighted percentage of assertions that passed.

Required range: 0 <= x <= 100
pass_fail
boolean
required

True iff score >= case.pass_threshold.

results
object[]
required