/api/v1/evals/{runId}Get eval run with results
Fetches a single eval run by id with its case results and aggregated scores. Case results are capped at the first 1,000 rows (ordered by created_at ascending), and the aggregates are computed over the rows returned — a run with more than 1,000 cases is truncated. Returns the raw `run` object plus flat top-level `status`, `score` and `passRate` convenience fields that the CLI/SDK poll, `results[]` (normalized `scores` map tolerant of both persisted `scorer_results` shapes), and `summary:{totalCases, passedCases, failedCases, passRate, avgScore, totalLatency, totalCost}`. Authorization is an explicit eval_run to project to org_members membership check inside the handler (403 NOT_ORG_MEMBER); a run with no resolvable project or org answers 404. 60 req/min.
Authentication
Send Authorization: Bearer YOUR_API_KEY on every request. Generate API keys at /dashboard/settings/api-keys.
Parameters
runId in pathrequiredstringResponse
200 example
{
"success": false,
"data": {
"run": {},
"results": [
{
"input": "string",
"expectedOutput": "string",
"actualOutput": "string",
"score": 0,
"passed": false,
"latency": 0,
"tokenUsage": {},
"scorerResults": {}
}
],
"summary": {
"totalCases": 0,
"passedCases": 0,
"failedCases": 0,
"passRate": 0,
"avgScore": 0,
"totalLatency": 0
}
}
}All status codes
Code samples
cURL
# {runId} is shown with an EXAMPLE value — replace it with real values.
curl -X GET \
https://evalguard.ai/api/v1/evals/00000000-0000-0000-0000-000000000000 \
-H "Authorization: Bearer $EVALGUARD_API_KEY"TypeScript
// The TypeScript SDK (@evalguard/sdk) exposes TYPED methods — runEval,
// getEval, runSecurityScan, checkFirewall, … — not a generic request().
// For an arbitrary endpoint, call it directly:
// {runId} is shown with an EXAMPLE value — replace it with real values.
const res = await fetch("https://evalguard.ai/api/v1/evals/00000000-0000-0000-0000-000000000000", {
method: "GET",
headers: { Authorization: `Bearer ${process.env.EVALGUARD_API_KEY}` },
});
console.log(res.status, await res.json());Python
# The Python SDK (pip install evalguardai) exposes TYPED methods on
# EvalGuardClient — run_eval, get_eval, … — not a generic request().
# For an arbitrary endpoint, call it directly:
# {runId} is shown with an EXAMPLE value — replace it with real values.
import os
import requests
headers = {"Authorization": f"Bearer {os.environ['EVALGUARD_API_KEY']}"}
response = requests.request("GET", "https://evalguard.ai/api/v1/evals/00000000-0000-0000-0000-000000000000", headers=headers)
print(response.status_code, response.json())Go
package main
import (
"context"
"fmt"
"net/http"
"os"
)
// {runId} is shown with an EXAMPLE value — replace it with real values.
func main() {
req, _ := http.NewRequestWithContext(context.Background(), "GET", "https://evalguard.ai/api/v1/evals/00000000-0000-0000-0000-000000000000", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("EVALGUARD_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
fmt.Println(resp.Status)
}