---
title: "Get a list of all the jobs in an IoT hub. For more information, see: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-identity-registry"
method: GET
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/jobs"
tags: ["GET"]
---

# Get a list of all the jobs in an IoT hub. For more information, see: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-identity-registry

`GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/jobs`

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/jobs`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

Get a list of all the jobs in an IoT hub. For more information, see: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-identity-registry.

## Path parameters

- `subscriptionId` string, uuid, required
- `resourceGroupName` string, required
- `resourceName` string, required

## Query parameters

- `api-version` string, required

## Response `200`

Azure operation completed successfully.

- JobResponseListResult: The JSON-serialized array of JobResponse objects with a next link.
  - `value` JobResponse[], required: The JobResponse items on this page
    - `jobId` string: The job identifier.
    - `startTimeUtc` string, date-time-rfc7231: The start time of the job.
    - `endTimeUtc` string, date-time-rfc7231: The time the job stopped processing.
    - `type` 'unknown' | 'export' | 'import' | 'backup' | 'readDeviceProperties' | 'writeDeviceProperties' | 'updateDeviceConfiguration' | 'rebootDevice' | 'factoryResetDevice' | 'firmwareUpdate': The type of the job.
    - `status` 'unknown' | 'enqueued' | 'running' | 'completed' | 'failed' | 'cancelled': The status of the job.
    - `failureReason` string: If status == failed, this string containing the reason for the failure.
    - `statusMessage` string: The status message for the job.
    - `parentJobId` string: The job identifier of the parent job, if any.
  - `nextLink` string, uri: The link to the next page of items

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/azure/apis/iothub-microsoft-devices-iothub.md) - [All operations](https://skmtc.dev/azure/apis/iothub-microsoft-devices-iothub/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/iothub-microsoft-devices-iothub/revisions/03e7327eb1d3?raw)
