---
title: "Returns a list of jobs."
method: GET
path: "/jobs"
tags: ["jobs"]
---

# Returns a list of jobs.

`GET /jobs`

Returns a list of all the jobs and their status.

## Response `200`

OK

- Jobs — jobID is a unique string, default: {cimc_ip}_{timestamp}, eg. '192.168.0.1_1628871425.1136827'
  - `jobID` JobStatus
    - `hostname` string
    - `host_ip` string
    - `cimcip` string
    - `start_time` string
    - `finish_time` string
    - `status` string
    - `macaddr` string
    - `netmask` string
    - `gateway` string

## Changes

- **2022-12-19** `3589a21876a9` — 1 warning, 4 info
  - removed the optional property `jobID/cimc_ip` from the response with the `200` status
  - added the optional property `jobID/cimcip` to the response with the `200` status
  - added the optional property `jobID/gateway` to the response with the `200` status
  - added the optional property `jobID/macaddr` to the response with the `200` status
  - …1 more
- **2022-09-29** `f44a5cd0e2db` — 1 warning, 1 info
  - removed the optional property `jobID/cimcip` from the response with the `200` status
  - added the optional property `jobID/cimc_ip` to the response with the `200` status
- **2022-09-29** `dbbd297a610d` — 1 warning, 1 info
  - removed the optional property `jobID/ipaddr` from the response with the `200` status
  - added the optional property `jobID/host_ip` to the response with the `200` status
- **2021-12-22** `13fb23422cbc` — 4 warning, 1 info
  - removed the optional property `jobID/gateway` from the response with the `200` status
  - removed the optional property `jobID/host_ip` from the response with the `200` status
  - removed the optional property `jobID/macaddr` from the response with the `200` status
  - removed the optional property `jobID/netmask` from the response with the `200` status
  - …1 more

[Change history](https://skmtc.dev/cisco/apis/esxi-autoinstaller/changes/jobs/get.md)

---

[API](https://skmtc.dev/cisco/apis/esxi-autoinstaller.md) · [All operations](https://skmtc.dev/cisco/apis/esxi-autoinstaller/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cisco/esxi-autoinstaller/revisions/dd322ba65a09/schema)