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

# Get Job Details

`GET /api/jobs/{submission_id}`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/ray-project/apis/ray-jobs-api/docs/api/jobs/:submission_id/get.ts> (a function with typed inputs; its response is checked against the schema)

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, nullable: 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, nullable: 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, nullable: 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, nullable: A message describing the status in more detail.
  - `error_type` string, nullable: Internal error, user script error
  - `start_time` integer, nullable: The time when the job was started. A Unix timestamp in ms.
  - `end_time` integer, nullable: The time when the job moved into a terminal state. A Unix timestamp in ms.
  - `metadata` object, nullable: Arbitrary user-provided metadata for the job.
  - `runtime_env` object, nullable: The runtime environment for the job.
  - `driver_agent_http_address` string, nullable: Driver agent http address.
  - `driver_node_id` string, nullable: Driver node id.

## Other responses

- `404`: The job does not exist.

## Changes

- **2026-10-29** `ee468f0281dc`: 12 breaking
  - the response property `driver_agent_http_address` became nullable for the status `200`
  - the response property `driver_info` became nullable for the status `200`
  - the response property `driver_info/allOf[subschema #1: DriverInfo]/` became nullable for the status `200`
  - the response property `driver_node_id` became nullable for the status `200`
  - …8 more

[Operation history](https://skmtc.dev/ray-project/apis/ray-jobs-api/changes/api/jobs/:submission_id/get.md)

---

[API](https://skmtc.dev/ray-project/apis/ray-jobs-api.md) - [All operations](https://skmtc.dev/ray-project/apis/ray-jobs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ray-project/apis/ray-jobs-api/revisions/ee468f0281dc?raw)