Get run details

Endpoint: GET /runs/{run_id}

Description
Returns a single run that belongs to the authenticated user, including every evaluation and a compact representation of each record.

Parameters

• Path: run_id — integer run id.

Error responses

• 401 — Authentication failed.
• 404 — Run with id run_id not found.
• 500 — Error retrieving the run.

Responses

• 200 — JSON object with the shape below.

Example response (200)

{
  "id": 991,
  "user": "analyst@acme.com",
  "run_type": "Dataset",
  "run_source": "API",
  "dataset": "Support QA - March",
  "data_collection": "Customer Support",
  "org_id": null,
  "number_of_metrics": 2,
  "result": 83.5,
  "threshold": 70,
  "model_slug": "gpt-4o",
  "alias": "support-march",
  "aggregate_results": {
    "ans_corr": 86,
    "faith": 81
  },
  "started_at": "2026-04-01T09:12:00Z",
  "finished_at": "2026-04-01T09:13:12Z",
  "is_gte_threshold": true,
  "evaluations": [
    {
      "id": 1542,
      "run_id": 991,
      "record_index": 0,
      "metric": "answer_correctness",
      "record": {
        "id": 1001,
        "prompt": "What is 2+2?",
        "input": null,
        "context": null,
        "output": "4",
        "golden_answer": "4"
      },
      "result": 100,
      "threshold": 70,
      "explanation": "Exact match.",
      "model_slug": "gpt-4o",
      "started_at": "2026-04-01T09:12:01Z",
      "finished_at": "2026-04-01T09:12:02Z",
      "credits_consumed": 1,
      "evaluation_cost": 0.0004,
      "is_success": true,
      "is_gte_threshold": true
    }
  ]
}

{
  "id": 0,
  "user": "string",
  "run_type": "string",
  "run_source": "string",
  "dataset": "string | null",
  "data_collection": "string | null",
  "org_id": "integer | null",
  "number_of_metrics": 0,
  "result": "number | null",
  "threshold": 0,
  "model_slug": "string | null",
  "alias": "string | null",
  "aggregate_results": "object | null",
  "started_at": "date",
  "finished_at": "date | null",
  "is_gte_threshold": "boolean | null",
  "evaluations": []
}

Each element of evaluations has this shape:

{
  "id": 0,
  "run_id": 0,
  "record_index": 0,
  "metric": "string",
  "record": {
    "id": 0,
    "prompt": "string | null",
    "input": "string | null",
    "context": "string | null",
    "output": "string | null",
    "golden_answer": "string | null"
  },
  "result": "number | null",
  "threshold": 0,
  "explanation": "string | null",
  "model_slug": "string | null",
  "started_at": "date",
  "finished_at": "date | null",
  "credits_consumed": "integer | null",
  "evaluation_cost": "number | string | null",
  "is_success": "boolean | null",
  "is_gte_threshold": "boolean | null"
}

curl

curl "https://api.aegisevals.ai/api/v1/runs/1" \
  -H "Authorization: Bearer sk_00000000000000000000000000000000"