---
title: "List Jobs"
method: GET
path: "/api/jobs"
---

# List Jobs

`GET /api/jobs`

List all submitted jobs in the cluster and their details.

## Response `200`

The details of the jobs.

- JobDetails[]
  - `type` 'SUBMISSION' | 'DRIVER', required — An enumeration for describing the different job types.
  - `entrypoint` string, required — The entrypoint command for this job.
  - `job_id` string — The job id. An id that is created for every job that is launched in Ray. This id can be used to fetch data about jobs using Ray core APIs.
  - `submission_id` string — A submission id is an id created for every submission job. This id can be used to fetch data about jobs using the job submission APIs.
  - `driver_info` DriverInfo — A class for recording information about the driver related to the job.
    - `id` string, required — The id of the driver
    - `node_ip_address` string, required — The ip address of the node the driver is running on
    - `pid` string, required — The pid of the worker process the driver is using.
  - `status` 'PENDING' | 'RUNNING' | 'STOPPED' | 'SUCCEEDED' | 'FAILED', required — An enumeration for describing the status of a job.
  - `message` string — A message describing the status in more detail.
  - `error_type` string — Internal error, user script error
  - `start_time` integer — The time when the job was started. A Unix timestamp in ms.
  - `end_time` integer — The time when the job moved into a terminal state. A Unix timestamp in ms.
  - `metadata` object — Arbitrary user-provided metadata for the job.
  - `runtime_env` object — The runtime environment for the job.
  - `driver_agent_http_address` string — Driver agent http address.
  - `driver_node_id` string — Driver node id.

---

[API](https://skmtc.net/ray-project/apis/ray-jobs-api.md) · [All operations](https://skmtc.net/ray-project/apis/ray-jobs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ray-project/ray-jobs-api/versions/ee557bc8498e/schema)