---
title: "Read a benchmark report"
method: GET
path: "/v1/benchmarks/{id}"
---

# Read a benchmark report

`GET /v1/benchmarks/{id}`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/benchmarks/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

Per-cell observed costs, timings and workload links

- BenchmarkReport
  - `id` string
  - `status` 'running' | 'completed' | 'failed'
  - `budget_usd` number: Deprecated compatibility field. Customer spending limits are not enforced.
  - `spend_usd` number
  - `created_at` string, date-time
  - `cells` BenchmarkCell[]
    - `gpu_family` string
    - `batch_size` integer
    - `region` string
    - `repetition` integer
    - `budget_usd` number: Deprecated compatibility field. Customer spending limits are not enforced.
    - `workload_id` string
    - `workload_url` string
    - `status` string
    - `spend_usd` number: Posted workload ledger charges. Active and unsettled usage may be absent.
    - `wall_seconds` number, nullable: Elapsed time from admission through terminal status or report time.
    - `unit_metrics` UnitMetrics
      - `units_completed` integer
      - `p50_ms` number, nullable
      - `p95_ms` number, nullable
      - `cost_per_unit_usd` number, nullable: Posted workload charges divided by observed unique completed units. Excludes unsettled charges.
      - `dropped_observations` integer: Runner queue overflow observations. A nonzero value means measurements are incomplete.
    - `units_per_second` number, nullable: Observed completed units divided by wall_seconds. Missing observations are not estimated.

## Other responses

- `404`: Benchmark not found

## Changes

- **2026-10-01** `ba84c74aeec8`: 2 info
  - response property `budget_usd` deprecated
  - response property `cells/items/budget_usd` deprecated
- **2026-10-01** `544fef290a54`: 2 info
  - response property `budget_usd` reactivated
  - response property `cells/items/budget_usd` reactivated
- **2026-09-27** `dcc58d93c2cb`: 2 info
  - response property `budget_usd` deprecated
  - response property `cells/items/budget_usd` deprecated
- **2026-09-27** `90c4cb8514af`: 2 info
  - response property `budget_usd` reactivated
  - response property `cells/items/budget_usd` reactivated
- **2026-09-26** `fddd7d91a5a5`: 2 info
  - response property `budget_usd` deprecated
  - response property `cells/items/budget_usd` deprecated

[Operation history](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/changes/v1/benchmarks/:id/get.md)

---

[API](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api.md) - [All operations](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/revisions/a59210899d95?raw)