---
title: "Get Job Details"
method: GET
path: "/api/jobs/{submission_id}"
---

# Get Job Details

`GET /api/jobs/{submission_id}`

Get the status and details of a job.

## Path parameters

- `submission_id` string, required

## Response `200`

The details of the job.

- JobDetails — Job data with extra details about its driver and its submission.
  - `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.

## Other responses

- `404` — The job does not exist.

---

[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/revisions/24ff8df8c1ae/schema)