nomad queue jobs command reference

The nomad queue jobs command lists the jobs in a node pool's batch job queue with each job's status and queue position.

Experimental

Experimental features are tested but unproven. Until the feature is verified through heavy production use, proceed with caution.

Usage

nomad queue jobs [options]

The queue jobs command lists each job that is waiting in the queue or that the queue sent to the scheduler. Nomad removes a job from the list after it places the job's allocations. Refer to Batch job queue for how the queue orders jobs, and to Queue batch jobs to configure a queue.

The output depends on the queue type.

For a first in, first out (FIFO) queue, the command lists each job's ID, status, position, and creation time.
For a dynamic priority queue, the command also lists each job's tenant, its adjusted priority, its base priority, and the fairshare, age, CPU, and memory adjustments that make up its adjusted priority.

The Status column shows queued for a job that is waiting in the queue and placing for a job that the queue sent to the scheduler. The job at position 0 is the job that the queue sent to the scheduler.

When the node pool does not have a batch job queue, the command returns No batch job queue configured for node pool: <node_pool>.

When ACLs are enabled, this command requires a token with the list-jobs capability. The command only lists jobs in namespaces where the token has the list-jobs capability.

Options

-node-pool: The node pool whose queue to list. This flag is required. When you omit it, the command returns node-pool is required and exits with code 255.
-p: List jobs in queue order, which is the order that the queue sends them to the scheduler. Without this flag, the command sorts jobs by job ID.
-per-page: The maximum number of jobs to return per page. When not set, or set to 0, the command returns all jobs.
-page-token: The pagination token from a previous page of results, which specifies where to start the next page.
-json: Output the jobs in JSON format.

General options

-address=<addr>: The address of the Nomad server. Overrides the NOMAD_ADDR environment variable if set. Defaults to http://127.0.0.1:4646.
-region=<region>: The region of the Nomad server to forward commands to. Overrides the NOMAD_REGION environment variable if set. Defaults to the Agent's local region.
-namespace=<namespace>: The target namespace for queries and actions bound to a namespace. Overrides the NOMAD_NAMESPACE environment variable if set. If set to '*', subcommands which support this functionality query all namespaces authorized to user. Defaults to the "default" namespace.
-no-color: Disables colored command output. Alternatively, NOMAD_CLI_NO_COLOR may be set. This option takes precedence over -force-color.
-force-color: Forces colored command output. This can be used in cases where the usual terminal detection fails. Alternatively, NOMAD_CLI_FORCE_COLOR may be set. This option has no effect if -no-color is also used.
-ca-cert=<path>: Path to a PEM encoded CA cert file to use to verify the Nomad server SSL certificate. Overrides the NOMAD_CACERT environment variable if set.
-ca-path=<path>: Path to a directory of PEM encoded CA cert files to verify the Nomad server SSL certificate. If both -ca-cert and -ca-path are specified, -ca-cert is used. Overrides the NOMAD_CAPATH environment variable if set.
-client-cert=<path>: Path to a PEM encoded client certificate for TLS authentication to the Nomad server. Must also specify -client-key. Overrides the NOMAD_CLIENT_CERT environment variable if set.
-client-key=<path>: Path to an unencrypted PEM encoded private key matching the client certificate from -client-cert. Overrides the NOMAD_CLIENT_KEY environment variable if set.
-tls-server-name=<value>: The server name to use as the SNI host when connecting via TLS. Overrides the NOMAD_TLS_SERVER_NAME environment variable if set.
-tls-skip-verify: Do not verify TLS certificate. This is highly not recommended. Verification will also be skipped if NOMAD_SKIP_VERIFY is set.
-token: The SecretID of an ACL token to use to authenticate API requests with. Overrides the NOMAD_TOKEN environment variable if set.

Examples

List the jobs in the FIFO queue of the batch node pool.

$ nomad queue jobs -node-pool batch
Batch Queue Workloads
JobID    Status   Position  CreatedAt
bravo    placing  0         2026-10-13T16:34:29-05:00
charlie  queued   1         2026-10-13T16:34:31-05:00

List the jobs in the dynamic priority queue of the batch node pool in queue order.

$ nomad queue jobs -node-pool batch -p
Batch Queue Workloads
JobID        Tenant  Status   Adjusted Priority  Base Priority  Position  Fairshare  Age  Cpu  Memory  CreatedAt
team-a-job2  team-a  placing  61                 50             0         0          0    4    7       2026-10-13T16:37:27-05:00
team-b-job1  team-b  queued   111                50             1         50         0    4    7       2026-10-13T16:37:28-05:00
team-b-job2  team-b  queued   111                50             2         50         0    4    7       2026-10-13T16:37:29-05:00
team-b-job3  team-b  queued   111                50             3         50         0    4    7       2026-10-13T16:37:30-05:00
team-a-job3  team-a  queued   61                 50             4         0          0    4    7       2026-10-13T16:37:27-05:00

List the first two jobs in queue order, and then list the next page.

$ nomad queue jobs -node-pool batch -p -per-page 2
Batch Queue Workloads
JobID        Tenant  Status   Adjusted Priority  Base Priority  Position  Fairshare  Age  Cpu  Memory  CreatedAt
team-a-job2  team-a  placing  61                 50             0         0          0    4    7       2026-10-13T16:37:27-05:00
team-b-job1  team-b  queued   111                50             1         50         0    4    7       2026-10-13T16:37:28-05:00

Results have been paginated. To get the next page run:

nomad queue jobs -node-pool batch -p -per-page 2 -page-token 81.team-b-job2

List the jobs in JSON format.

$ nomad queue jobs -node-pool batch -json
[{"JobID":"bravo","Position":0,"Status":"placing","CreatedAt":1791927269790224000},{"JobID":"charlie","Position":1,"Status":"queued","CreatedAt":1791927271419212000}]