# Query Job Details

## Function Introduction

Query single job details, obtain driver program detailed information, job status and other content.

## URI

GET `/api/jobs/{submissionId}`

Path Parameters:

| **Parameter** | **Required** | **Parameter Type** | **Description** |
| ------------ | ------------ | ------------ | ------------- |
| submissionId | Yes | String | Job instance id. |

## Response Parameters

| **Parameter** | **Parameter Type** | **Description** |
| ------------ | ------------ | ------------ |
| type | string | Used to identify job category. Currently: SUBMISSION. |
| submission_id | string | Job id. |
| driver_info | [DriverInfo](api-data-struct-get-driverinfo) object | Detailed information of driver program associated with job. |
| status | string | Current running status of job. |
| start_time | string | Job start timestamp, unit in milliseconds. |
| end_time | string | Job end timestamp, unit in milliseconds. |
| metadata | map[string]string | Job metadata. |
| runtime_env | map[string]interface{} | Job runtime environment. |
| driver_agent_http_address | string | Not enabled yet. |
| driver_node_id | string | Id of node where driver program runs. |
| driver_exit_code | int32 | Exit code of driver program. |
| error_type | string | Class and identification of problem caused by internal error or user-provided script error. |

(api-data-struct-get-driverinfo)=

<br> DriverInfo Type Parameters

| **Parameter** | **Parameter Type** | **Description** |
| ------------ | ------------ | ------------ |
| id | string | Unique identifier of driver program. |
| node_ip_address | string | IP address of node where driver program is located. |
| pid | string | Process id of driver program process. |

## Request Example

GET {[frontend endpoint](api-frontend-endpoint)}/api/jobs/{submissionId}

## Response Example

Query successful

```json
{
  "type": "SUBMISSION",
  "entrypoint": "python script_yr_sleep.py",
  "submission_id": "app-fe4ee1e5-d24f-4236-be15-7654e3c2229b",
  "driver_info": {
    "id": "app-fe4ee1e5-d24f-4236-be15-7654e3c2229b",
    "node_ip_address": "7.183.38.81",
    "pid": "748250"
  },
  "status": "SUCCEEDED",
  "start_time": "1755484077",
  "end_time": "1755484140",
  "metadata": {
    "autoscenes_ids": "auto_1-test",
    "task_type": "task_1",
    "ttl": "1250"
  },
  "runtime_env": {
    "envVars": "{\"DEPLOY_REGION\":\"suzhou_std\",\"SOURCE_REGION\":\"suzhou_std\"}",
    "pip": "pip3.9 install numpy==1.24 scipy==1.11.0 && pip3.9 check",
    "working_dir": "file:///home/disk/tk/file.zip"
  },
  "driver_agent_http_address": "",
  "driver_node_id": "node2-744947",
  "driver_exit_code": 0,
  "error_type": ""
}
```

Query failed, submissionId not found

```text
"not found app, submissionId: app-xxxxx, err: failed to get appjobInfo, submissionID: app-xxxxx"
```

## Error Codes

Please refer to [Error Codes](error-code-rest-api).