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

# GET /jobs

`GET /jobs`

Lists the jobs, if any, associated with the specified Data Lake Analytics account. The response includes a link to the next page of results, if any.

## Query parameters

- `$filter` string
- `$top` integer
- `$skip` integer
- `$select` string
- `$orderby` string
- `$count` boolean
- `api-version` string, required

## Response `200`

Successfully retrieved the list of jobs.

- JobInfoListResult — List of JobInfo items.
  - `value` JobInformationBasic[] — The list of JobInfo items.
    - `jobId` string, uuid — The job's unique identifier (a GUID).
    - `name` string, required — The friendly name of the job.
    - `type` 'USql' | 'Hive' | 'Scope', required — The job type of the current job (Hive, USql, or Scope (for internal use only)).
    - `submitter` string — The user or account that submitted the job.
    - `degreeOfParallelism` integer — The degree of parallelism used for this job.
    - `degreeOfParallelismPercent` number, double — the degree of parallelism in percentage used for this job.
    - `priority` integer — The priority value for the current job. Lower numbers have a higher priority. By default, a job has a priority of 1000. This must be greater than 0.
    - `submitTime` string, date-time — The time the job was submitted to the service.
    - `startTime` string, date-time — The start time of the job.
    - `endTime` string, date-time — The completion time of the job.
    - `state` 'Accepted' | 'Compiling' | 'Ended' | 'New' | 'Queued' | 'Running' | 'Scheduling' | 'Starting' | 'Paused' | 'WaitingForCapacity' | 'Yielded' | 'Finalizing' — The job state. When the job is in the Ended state, refer to Result and ErrorMessage for details.
    - `result` 'None' | 'Succeeded' | 'Cancelled' | 'Failed' — The result of job execution or the current result of the running job.
    - `logFolder` string — The log folder path to use in the following format: adl://<accountName>.azuredatalakestore.net/system/jobservice/jobs/Usql/2016/03/13/17/18/5fe51957-93bc-4de0-8ddc-c5a4753b068b/logs/.
    - `logFilePatterns` string[] — The list of log file name patterns to find in the logFolder. '*' is the only matching character allowed. Example format: jobExecution*.log or *mylog*.txt
    - `related` JobRelationshipProperties — Job relationship information properties including pipeline information, correlation information, etc.
      - `pipelineId` string, uuid — The job relationship pipeline identifier (a GUID).
      - `pipelineName` string — The friendly name of the job relationship pipeline, which does not need to be unique.
      - `pipelineUri` string — The pipeline uri, unique, links to the originating service for this pipeline.
      - `runId` string, uuid — The run identifier (a GUID), unique identifier of the iteration of this pipeline.
      - `recurrenceId` string, uuid, required — The recurrence identifier (a GUID), unique per activity/script, regardless of iterations. This is something to link different occurrences of the same job together.
      - `recurrenceName` string — The recurrence name, user friendly name for the correlation between jobs.
    - `tags` object — The key-value pairs used to add additional metadata to the job information. (Only for use internally with Scope job type.)
    - `hierarchyQueueNode` string — the name of hierarchy queue node this job is assigned to, Null if job has not been assigned yet or the account doesn't have hierarchy queue.
  - `nextLink` string — The link (url) to the next page of results.

---

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