---
title: "GET /templeton/v1/jobs"
method: GET
path: "/templeton/v1/jobs"
tags: ["Job"]
---

# GET /templeton/v1/jobs

`GET /templeton/v1/jobs`

Gets the list of jobs from the specified HDInsight cluster.

## Query parameters

- `user.name` string, required
- `showall` 'true', required
- `fields` '*', required

## Response `200`

OK response definition.

- JobListJsonObject[]
  - `detail` JobDetailRootJsonObject — The object containing the job details.
    - `callback` object — The callback URL, if any.
    - `completed` string — The string representing completed status, for example 'done'.
    - `exitValue` integer — The job's exit value.
    - `id` string — The job ID.
    - `msg` object — The message returned.
    - `parentId` string — The parent job ID.
    - `percentComplete` string — The job completion percentage, for example '75% complete'.
    - `profile` Profile — The object containing the job profile information.
      - `jobFile` string — The job configuration file.
      - `jobId` string — The full ID of the job.
      - `jobID` JobID — The object with the Job ID.
        - `id` integer — The job number.
        - `jtIdentifier` string — The jobTracker identifier.
      - `jobName` string — The user-specified job name.
      - `queueName` string — The name of the queue to which the job is submitted.
      - `url` string — The link to the web-ui for details of the job.
      - `user` string — The userid of the person who submitted the job.
    - `status` Status — Gets or sets the object containing the job status information.
      - `cleanupProgress` number, double — The progress made on the cleanup.
      - `failureInfo` string — The information about any failures that have occurred.
      - `finishTime` integer — The time at which the job completed. It is an integer in milliseconds, as a Unix timestamp relative to 1/1/1970 00:00:00.
      - `historyFile` string — The history file of the job.
      - `jobACLs` unknown
      - `jobComplete` boolean — Whether or not the job has completed.
      - `jobFile` string — The job configuration file.
      - `jobId` string — The full ID of the job.
      - `jobID` JobID — The object with the Job ID.
        - `id` integer — The job number.
        - `jtIdentifier` string — The jobTracker identifier.
      - `jobName` string — The user-specified job name.
      - `jobPriority` string — The priority of the job.
      - `mapProgress` number, double — The progress made on the maps.
      - `neededMem` integer — The amount of memory needed for the job.
      - `numReservedSlots` integer — The number of slots reserved.
      - `numUsedSlots` integer — The number of slots used for the job.
      - `priority` string — The priority of the job.
      - `queue` string — The job queue name.
      - `reduceProgress` number, double — The progress made on the reduces.
      - `reservedMem` integer — The amount of memory reserved for the job.
      - `retired` boolean — Whether or not the job has been retired.
      - `runState` integer — The current state of the job.
      - `schedulingInfo` string — The information about the scheduling of the job.
      - `setupProgress` number, double — The progress made on the setup.
      - `startTime` integer — The time at which the job started. It is an integer in milliseconds, as a Unix timestamp relative to 1/1/1970 00:00:00.
      - `state` string — The state of the job.
      - `trackingUrl` string — The link to the web-ui for details of the job.
      - `uber` boolean — Whether job running in uber mode.
      - `usedMem` integer — The amount of memory used by the job.
      - `username` string — The userid of the person who submitted the job.
    - `user` string — The user name of the job creator.
    - `userargs` Userargs — Gets or sets the object containing the user arguments.
      - `arg` string[] — The list of args defined by the user.
      - `callback` object — The callback URL, if any.
      - `define` string[] — The define properties defined by the user.
      - `enablelog` string — Whether or not the user enabled logs.
      - `execute` string — The query defined by the user.
      - `file` object — The query file provided by the user.
      - `files` object — The files defined by the user.
      - `jar` string — The JAR file provided by the user.
      - `statusdir` object — The status directory defined by the user.
  - `id` string — The Id of the job.

## Other responses

- `default` — Error response describing why the operation failed.

---

[API](https://skmtc.net/azure/apis/hdinsightjobclient.md) · [All operations](https://skmtc.net/azure/apis/hdinsightjobclient/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/hdinsightjobclient/revisions/3ca9bade5a34/schema)