> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.vessl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List batch jobs

> Browse, filter, and search jobs in your team.

The **Jobs** page lists every batch job in your team and lets you filter by status and tags.

<div>
  <Frame>
    <img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/dora/LUWzC5lx5RwOccfw/images/Job_list(tag).png?fit=max&auto=format&n=LUWzC5lx5RwOccfw&q=85&s=5ad5dae76dca897c75cd9435852ab170" alt="Jobs list page with name, slug, status, tags, requested resources, duration, creator, and created-at columns" width="7680" height="4320" data-path="images/Job_list(tag).png" />
  </Frame>

  <small>Example: Jobs list page</small>
</div>

<Info>
  The list shows the following columns:

  * **Name**: Job name
  * **Slug**: Unique identifier used by `vesslctl` commands
  * **Status**: Current lifecycle state (`scheduling`, `running`, `succeeded`, `failed`, `terminated`)
  * **Tags**: Tags on the job, shown as colored chips (extra tags collapse to `+N`).
  * **Requested Resources**: Requested GPU type and count
  * **Duration**: Time elapsed since the job started
  * **Creator**: User who submitted the job
  * **Created at**: When the job was created
</Info>

## Filter by status

Use the status dropdown above the list to filter by `scheduling`, `running`, `succeeded`, `failed`, or `terminated`. By default, all statuses are shown.

## Filter by tag

A tag filter sidebar on the left of the **Jobs** list narrows results to jobs that carry one or more selected tags. Tags are managed inline on each job's details page (see [View job details](/member/job/details)).

<div>
  <Frame>
    <img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/dora/LUWzC5lx5RwOccfw/images/job_tags.png?fit=max&auto=format&n=LUWzC5lx5RwOccfw&q=85&s=14eb1bc25239da392a637fd059ef3853" alt="Jobs list with a tag filter sidebar on the left and colored tag chips on individual job rows" width="3162" height="1026" data-path="images/job_tags.png" />
  </Frame>

  <small>Example: Tag filter sidebar</small>
</div>

## From the CLI

```bash theme={null}
vesslctl job list                        # all jobs in the current team
vesslctl job list --state running        # only running jobs
vesslctl job list --hide-deleted         # skip cancelled and terminated jobs
vesslctl job list --per-page 50          # paginate
```

See [`vesslctl job list`](/cli/commands/job#list) for the full reference.

## See also

* [Create a batch job](/member/job/create)
* [View job details](/member/job/details)
* [Clean up jobs](/member/job/cleanup)