> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blackbox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Benchmark Results

> Final (or in-progress) score for a benchmark run — headline percentage, per-task pass/fail with verdict + duration, the underperformers, and an inline tracking log. Everything for one run, by id.

The rich, single-call view of a benchmark run. Unlike [status](/api-reference/v1/benchmark-logs) (a lightweight progress poll), this returns the aggregated metric **as a percentage** plus a per-task breakdown with traces. It works mid-run (partial, reflecting progress) and after completion.

## Authentication

All requests require a BLACKBOX API key as a Bearer token. A run is only readable by the user that created it. See [Authentication](/api-reference/v1/authentication).

## Headers

<ParamField header="Authorization" type="string" required>
  API Key of the form `Bearer <api_key>`.
</ParamField>

## Path Parameters

<ParamField path="benchmarkRunId" type="string" required>
  The id returned by [Run Benchmarks](/api-reference/v1/benchmarks).
</ParamField>

## Response

<ResponseField name="percentage" type="number">
  The headline score — `resolved / total × 100` (2 decimal places). Prefers the recorded final rate; falls back to live counters mid-run.
</ResponseField>

<ResponseField name="resolvedRate" type="number | null">
  Fraction `0..1` recorded on completion (`null` until then).
</ResponseField>

<ResponseField name="metric" type="string">
  What the percentage measures — e.g. `accuracy` (QA) or `resolved_rate` (SWE).
</ResponseField>

<ResponseField name="agent" type="string">
  The runtime that actually ran — `"claude"`, `"codex"`, or `"grok"`.
</ResponseField>

<ResponseField name="score" type="object">
  `{ resolved, total, completed, failed }` counters.
</ResponseField>

<ResponseField name="summary" type="object">
  Per-status tally: `{ resolved, unresolved, errored, pending, running }`.
</ResponseField>

<ResponseField name="timing" type="object">
  Latency rollup: `{ totalDurationMs, avgTaskMs, slowestTaskMs, fastestTaskMs }` — your "where did it lag" signal.
</ResponseField>

<ResponseField name="tasks" type="array">
  One object per instance, with the trace fields:

  <Expandable title="task fields">
    <ResponseField name="instanceId" type="string">Dataset instance id (e.g. `aime__60`).</ResponseField>
    <ResponseField name="status" type="string">`resolved` | `unresolved` | `errored` | `running` | `pending`.</ResponseField>
    <ResponseField name="reward" type="number | null">`1` = passed, `0` = failed (`null` until verified).</ResponseField>
    <ResponseField name="durationMs" type="number | null">Per-task latency.</ResponseField>
    <ResponseField name="sandboxId" type="string | null">The isolated sandbox that ran it — for traceability.</ResponseField>
    <ResponseField name="grade" type="string | null">The verifier's verdict line (e.g. `answer="204" gold="204" → PASS`).</ResponseField>
    <ResponseField name="error" type="string | null">Error message, if any.</ResponseField>
    <ResponseField name="startedAt" type="string | null">ISO timestamp.</ResponseField>
    <ResponseField name="completedAt" type="string | null">ISO timestamp.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="underperformed" type="array">
  The failed/errored tasks only, **slowest first** — each with `instanceId`, `status`, `durationMs`, `error`, and `grade`. The "what did it miss / where did it lag" view.
</ResponseField>

<ResponseField name="tracking" type="object">
  Inline log for tracking, so you can follow a run without a second call:

  <Expandable title="tracking fields">
    <ResponseField name="logSource" type="string">`live` (from the in-memory buffer while running) or `persisted` (from the DB after the run ends).</ResponseField>
    <ResponseField name="logLineCount" type="number">Total lines available.</ResponseField>
    <ResponseField name="recentLogs" type="array">The last \~25 log lines.</ResponseField>
    <ResponseField name="logsUrl" type="string">Path to the full log snapshot.</ResponseField>
    <ResponseField name="streamUrl" type="string">Path to the SSE log stream.</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  curl 'https://agent.blackbox.ai/api/v1/benchmarks/runs/RUN_ID/results' \
    -H 'Authorization: Bearer YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json Success (aime, grok, 90%) theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "benchmarkRunId": "b41ab8b2-9363-489a-99a1-5af2f9649b92",
    "benchmark": "aime",
    "dataset": "aime-2024-2025",
    "model": "blackboxai/x-ai/grok-build-0.1",
    "agent": "grok",
    "status": "completed",
    "progress": 100,
    "metric": "accuracy",
    "percentage": 90,
    "resolvedRate": 0.9,
    "score": { "resolved": 9, "total": 10, "completed": 10, "failed": 0 },
    "summary": { "resolved": 9, "unresolved": 1, "errored": 0, "pending": 0, "running": 0 },
    "timing": { "totalDurationMs": 465278, "avgTaskMs": 158648, "slowestTaskMs": 365055, "fastestTaskMs": 47887 },
    "tasks": [
      {
        "instanceId": "aime__60",
        "status": "resolved",
        "reward": 1,
        "durationMs": 47887,
        "sandboxId": "bench-b41ab8b2-…-t0",
        "error": null,
        "grade": "[task aime__60] graded numeric_match: answer=\"204\" gold=\"204\" → PASS",
        "startedAt": "2026-06-13T22:48:15.013Z",
        "completedAt": "2026-06-13T22:49:02.900Z"
      }
    ],
    "underperformed": [
      {
        "instanceId": "aime__63",
        "status": "unresolved",
        "durationMs": 365055,
        "error": null,
        "grade": "[task aime__63] unresolved (365.1s)"
      }
    ],
    "tracking": {
      "logSource": "persisted",
      "logLineCount": 92,
      "recentLogs": [ "…", "[done] resolved 9/10 (resolved_rate=0.9000)" ],
      "logsUrl": "/api/v1/benchmarks/runs/b41ab8b2-…/logs",
      "streamUrl": "/api/v1/benchmarks/runs/b41ab8b2-…/logs/stream"
    },
    "error": null,
    "startedAt": "2026-06-13T22:47:00.782Z",
    "completedAt": "2026-06-13T22:54:46.060Z"
  }
  ```
</ResponseExample>

## What you can answer by id

| Question                      | Field                                           |
| ----------------------------- | ----------------------------------------------- |
| Which tests failed?           | `tasks[].status` / `reward`, `underperformed[]` |
| Where did it lag?             | `tasks[].durationMs`, `timing`                  |
| What did it answer vs gold?   | `tasks[].grade`                                 |
| Which sandbox ran it?         | `tasks[].sandboxId`                             |
| How do I track progress live? | `tracking.recentLogs` (+ `streamUrl`)           |

<Card title="Benchmark Logs & Status" icon="signal-stream" href="/api-reference/v1/benchmark-logs">
  Poll status and stream the full logs (live, then replayed from the DB).
</Card>