---
layout: commands
page_title: 'Commands: Job list'
sidebar_title: 'job list'
description: 'List all jobs in Waypoint'
---

# Waypoint Job list

Command: `waypoint job list`

List all jobs in Waypoint

@include "commands/job-list_desc.mdx"

## Usage

Usage: `waypoint job list [options]`

List known jobs from Waypoint server.
Options to filter job list by project, workspace, target runner, pipeline, and pipeline run.

#### Global Options

- `-plain` - Plain output: no colors, no animation. The default is false.
- `-app=<string>` (`-a`) - App to target. Certain commands require a single app target for Waypoint configurations with multiple apps. If you have a single app, then this can be ignored.
- `-project=<string>` (`-p`) - Project to target.
- `-workspace=<string>` (`-w`) - Workspace to operate in.

#### Operation Options

- `-label=<key=value>` - Labels to set for this operation. Can be specified multiple times.
- `-local` - True to use a local runner to execute the operation, false to use a remote runner.
  If unset, Waypoint will automatically determine where the operation will occur,
  defaulting to remote if possible.
- `-remote-source=<key=value>` - Override configurations for how remote runners source data. This is specified to the data source type being used in your configuration. This is used for example to set a specific Git ref to run against.
- `-var=<key=value>` - Variable value to set for this operation. Can be specified multiple times.
- `-var-file=<string>` - HCL or JSON file containing variable values to set for this operation. If any "_.auto.wpvars" or "_.auto.wpvars.json" files are present, they will be automatically loaded.

#### Command Options

- `-state=<string>` - List jobs that only match the requested state. Can be repeated multiple times. One possible value from: Success, Error, Running, Waiting, Queued, Unknown.
- `-target-runner-id=<string>` - List jobs that were only assigned to the target runner by id.
- `-target-runner-label=<key=value>` - List jobs that were only assigned to the target runner by labels. Can be repeated multiple times.
- `-pipeline-id=<string>` - List jobs initiated by the specific pipeline, look up by pipeline ID.
- `-pipeline-name=<string>` - List jobs initiated by the specific pipeline, look up by pipeline owner.
- `-run=<int>` - List jobs initiated by the specific pipeline run, only valid used together with -pipeline.
- `-desc` - Output the list of jobs from newest to oldest. The default is false.
- `-json` - Output the list of jobs as json. The default is false.
- `-limit=<int>` - If set, will limit the number of jobs to list.

@include "commands/job-list_more.mdx"
