---
title: "ListFOTAJobs"
method: GET
path: "/fota-jobs"
tags: ["FOTA Jobs"]
---

# ListFOTAJobs

`GET /fota-jobs`

## Query parameters

- `pageLimit` integer — Maximum number of items you want returned in the response (<=100).
- `pageNextToken` string — If available in the initial response, use this token to retrieve the next page of items in the list. When supplying as a request parameter, use URL-encoding.

## Response `200`

Ok

- PaginatedResultFOTAV2JobOrFotaJobV2Plus
  - `items` union[], required
    - union
      - FOTAV2Job
        - `jobId` string, required — Universally unique identifier
        - `target` FotaV2JobTargetModel, required
          - `deviceIds` DeviceId[], required
          - `tags` DeviceTag[], required
        - `description` string
        - `status` 'CREATED' | 'IN_PROGRESS' | 'CANCELLED' | 'DELETION_IN_PROGRESS' | 'COMPLETED', required
        - `statusDetail` string
        - `createdAt` string, date-time
        - `lastUpdatedAt` string, date-time
        - `completedAt` string, date-time
        - `name` string
        - `executionStats` object, required
          - `completedExecutions` number, double, required
          - `executions` number, double, required
          - `devices` number, double, required
          - `timedOut` number, double, required
          - `removed` number, double, required
          - `downloading` number, double, required
          - `inProgress` number, double, required
          - `queued` number, double, required
          - `rejected` number, double, required
          - `failed` number, double, required
          - `succeeded` number, double, required
          - `cancelled` number, double, required
        - `firmware` object, required
          - `bundleId` union, required
            - string — Unique bundle identifier
            - string — Universally unique identifier
          - `host` string, required
          - `fileSize` number, double, required
          - `firmwareType` 'APP' | 'MODEM' | 'BOOT' | 'SOFTDEVICE' | 'BOOTLOADER' | 'MDM_FULL' | 'SMP' | 'CUSTOM', required — Firmware types that can be specified in the device's shadow in reported.device.serviceInfo.fota_v2 and in its Elasticsearch document in the firmware.supports array.
          - `version` string, required
          - `uris` string[], required
      - FotaJobV2Plus — Elivagar FOTA Job definition for integration with device-job-service
        - `jobId` string, required — Universally unique identifier
        - `target` object, required
          - `firmwareVersions` FirmwareVersion[]
          - `firmwareType` 'APP' | 'MODEM' | 'BOOT' | 'SOFTDEVICE' | 'BOOTLOADER' | 'MDM_FULL' | 'SMP' | 'CUSTOM' — Firmware types that can be specified in the device's shadow in reported.device.serviceInfo.fota_v2 and in its Elasticsearch document in the firmware.supports array.
          - `tags` DeviceTag[], required
          - `deviceIds` DeviceId[], required
        - `description` string
        - `status` 'CREATED' | 'IN_PROGRESS' | 'CANCELLED' | 'DELETION_IN_PROGRESS' | 'COMPLETED', required
        - `statusDetail` string
        - `createdAt` string, date-time
        - `lastUpdatedAt` string, date-time
        - `completedAt` string, date-time
        - `name` string
        - `executionStats` object, required
          - `completedExecutions` number, double, required
          - `executions` number, double, required
          - `devices` number, double, required
          - `timedOut` number, double, required
          - `removed` number, double, required
          - `downloading` number, double, required
          - `inProgress` number, double, required
          - `queued` number, double, required
          - `rejected` number, double, required
          - `failed` number, double, required
          - `succeeded` number, double, required
          - `cancelled` number, double, required
        - `firmware` object, required
          - `bundleId` union, required
            - string — Unique bundle identifier
            - string — Universally unique identifier
          - `host` string, required
          - `fileSize` number, double, required
          - `firmwareType` 'APP' | 'MODEM' | 'BOOT' | 'SOFTDEVICE' | 'BOOTLOADER' | 'MDM_FULL' | 'SMP' | 'CUSTOM', required — Firmware types that can be specified in the device's shadow in reported.device.serviceInfo.fota_v2 and in its Elasticsearch document in the firmware.supports array.
          - `version` string, required
          - `uris` string[], required
        - `schedule` JobSchedule
          - `startJobAtEpochMs` number, double — Determine the date when the job should automatically start. Number of milliseconds for this date since the UNIX epoch.
          - `lockTargetListAtEpochMs` number, double — Determine the date in which the target list should automatically be set to LOCKED. Number of milliseconds for this date since the UNIX epoch.
        - `targetListType` 'LOCKED' | 'UNLOCKED'
  - `total` integer — Reflects the total results returned by the query, which may be less than the total number of items available. If the response contains a `pageNextToken` value, you can supply the `pageNextToken` in the next request to get more results. The maximum value of `total` is the page limit of the request, or ten pages if no page limit is provided.
  - `pageNextToken` string — Token used to retrieve the next page of items in the list. Present in a response only if the total available results exceeds the specified limit on a page. This token does not change between requests. When supplying as a request parameter, use URL-encoding.

---

[API](https://skmtc.dev/nrfcloud/apis/nrf-cloud-rest-api.md) · [All operations](https://skmtc.dev/nrfcloud/apis/nrf-cloud-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nrfcloud/nrf-cloud-rest-api/revisions/c4e56e458ebf/schema)