---
title: "List all jobs"
method: GET
path: "/jobs"
---

# List all jobs

`GET /jobs`

## Query parameters

- `job_definition_id` string
- `status` 'CREATED' | 'QUEUED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'STOPPING' | 'STOPPED'
- `name` string
- `tags` string[]
- `start_time` integer
- `sort_by` SortField[]
  - `name` string
  - `direction` 'asc' | 'desc'
- `max_items` integer
- `next_token` string

## Response `200`

Successfully retrieved the list of jobs.

- ListJobsResponse
  - `jobs` DescribeJob[]
    - `job_id` string
    - `input_filename` string
    - `runtime_environment_name` string
    - `runtime_environment_parameters` object
    - `output_formats` string[]
    - `parameters` object
    - `tags` string[]
    - `name` string
    - `output_filename_template` string
    - `compute_type` string
    - `job_files` JobFile[]
      - `display_name` string
      - `file_format` string
      - `file_path` string
    - `create_time` integer
    - `update_time` integer
    - `start_time` integer
    - `end_time` integer
    - `status` 'CREATED' | 'QUEUED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'STOPPING' | 'STOPPED'
    - `status_message` string
    - `downloaded` boolean
    - `package_input_folder` boolean
    - `packaged_files` string[]
  - `total_count` integer
  - `next_token` string

## Other responses

- `500` — Server error

---

[API](https://skmtc.net/jupyter-server/apis/jupyter-scheduler-api.md) · [All operations](https://skmtc.net/jupyter-server/apis/jupyter-scheduler-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jupyter-server/jupyter-scheduler-api/versions/f49a837fc1f2/schema)