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

# List jobs for a project

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

➕ Bencher Plus: List all jobs for a project. The job output is not included in the list response. 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. By default, the jobs are sorted by creation date time in reverse chronological order. The HTTP response header `X-Total-Count` contains the total number of jobs.

## Path parameters

- `project` string, required

## Query parameters

- `direction` 'asc' | 'desc'
- `page` integer, nullable
- `per_page` integer, nullable
- `sort` 'created' — Sort by creation date time.
- `status` 'pending' | 'claimed' | 'running' | 'completed' | 'processed' | 'failed' | 'canceled' — Job status

## Response `200`

successful operation

- JsonJob[] — A list of jobs
  - `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/versions/84086e99e6cd/schema)