---
title: "View a job"
method: GET
path: "/v0/projects/{project}/jobs/{job}"
tags: ["projects", "jobs"]
---

# View a job

`GET /v0/projects/{project}/jobs/{job}`

➕ Bencher Plus: View a job for a project. If the project is public, then the user does not need to be authenticated. If the project is private, then the user must be authenticated and have `view` permissions for the project, or provide a valid project key for the project. The job output is only included in the response for terminal (completed, failed, or canceled) jobs when the user is authenticated and has `view` permissions for the project.

## Path parameters

- `job` string, uuid, required
- `project` string, required

## Response `200`

successful operation

- JsonJob — A benchmark job
  - `claimed` string, date-time
  - `completed` string, date-time
  - `config` JsonJobConfig — Job configuration sent to runners. Contains the execution details needed for a runner to execute a job. Designed to minimize data leakage - runners only learn what's necessary to pull and execute an OCI image. Resource requirements (cpu, memory, disk, network) are in the associated spec.
    - `allow_failure` boolean, nullable — Allow benchmark failure without short-circuiting iterations
    - `average` 'mean' | 'median'
    - `backdate` string, date-time
    - `build_time` boolean, nullable — Track the build time of the benchmark command
    - `cmd` string[], nullable — Command override (like Docker CMD)
    - `digest` string, required — An OCI image digest in the format `algorithm:hex`. Supports: - `sha256:` followed by 64 hex characters - `sha512:` followed by 128 hex characters
    - `entrypoint` string[], nullable — Entrypoint override (like Docker ENTRYPOINT)
    - `env` object, nullable — Environment variables passed to the container
    - `file_paths` string[], nullable — File paths to read from the VM after job completion
    - `file_size` boolean, nullable — Track the file size of the output files instead of parsing their contents
    - `fold` 'min' | 'max' | 'mean' | 'median'
    - `image` string
    - `iter` integer
    - `project` string, uuid, required
    - `registry` string, required
    - `timeout` integer, required
  - `created` string, date-time, required
  - `modified` string, date-time, required
  - `output` JsonJobOutput — Job output stored in blob storage after job completion or failure.
    - `error` string, nullable — Error message (present when the job failed).
    - `results` JsonIterationOutput[], required — Per-iteration results
      - `exit_code` integer, required — Exit code from the benchmark command
      - `output` object, nullable — File path to contents map
      - `stderr` string, nullable — Standard error from the benchmark
      - `stdout` string, nullable — Standard output from the benchmark
  - `runner` string, uuid
  - `spec` JsonSpec, required — A hardware spec
    - `architecture` 'x86_64' | 'aarch64', required
    - `archived` string, date-time
    - `cpu` integer, required
    - `created` string, date-time, required
    - `disk` integer, required
    - `fallback` string, date-time
    - `memory` integer, required
    - `modified` string, date-time, required
    - `name` string, required
    - `network` boolean, required
    - `os` 'linux' | 'macos' | 'windows', required
    - `sandbox` 'firecracker'
    - `slug` string, required
    - `uuid` string, uuid, required
  - `started` string, date-time
  - `status` 'pending' | 'claimed' | 'running' | 'completed' | 'processed' | 'failed' | 'canceled', required — Job status
  - `uuid` string, uuid, required

## Other responses

- `4XX` — Error
- `5XX` — Error

---

[API](https://skmtc.net/bencherdev/apis/bencher-api.md) · [All operations](https://skmtc.net/bencherdev/apis/bencher-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bencherdev/bencher-api/revisions/84086e99e6cd/schema)