---
title: "Get the list of scheduled job definitions in an application"
method: GET
path: "/scheduledJobs"
---

# Get the list of scheduled job definitions in an application

`GET /scheduledJobs`

## Query parameters

- `api-version` string, required
- `maxpagesize` integer

## Response `200`

Success

- ScheduledJobCollection — The paged results of scheduled job definitions.
  - `value` ScheduledJob[], required — The collection of scheduled jobs.
    - `etag` string — ETag used to prevent conflict in scheduled job updates.
    - `id` string — Unique ID of the scheduled job.
    - `displayName` string — Display name of the scheduled job.
    - `description` string — Detailed description of the scheduled job.
    - `group` string, required — The ID of the device group on which to execute the scheduled job.
    - `batch` JobBatch — The job batch definition.
      - `type` 'number' | 'percentage', required — Whether batching is done on a specified number of devices or a percentage of the total devices.
      - `value` number, required — The number or percentage of devices on which batching is done.
    - `cancellationThreshold` JobCancellationThreshold — The job cancellation threshold definition.
      - `type` 'number' | 'percentage', required — Whether the cancellation threshold is per a specified number of devices or a percentage of the total devices.
      - `value` number, required — The number or percentage of devices on which the cancellation threshold is applied.
      - `batch` boolean — Whether the cancellation threshold applies per-batch or to the overall job.
    - `data` JobData[], required — Data related to the operation being performed by this job. All entries must be of the same type.
      - `type` string, required — Type of the job data.
    - `organizations` string[] — List of organizations of the job, only one organization is supported today, multiple organizations will be supported soon.
    - `schedule` JobSchedule, required — The schedule definition of job.
      - `recurrence` 'daily' | 'weekly' | 'monthly' — The recurrence of the scheduled job. If not provided, the job will run once at the specified start time.
      - `start` string, date-time, required — The start time for the scheduled job
      - `end` JobScheduleEnd — The end definition of job schedule.
        - `type` string, required — Type of the job schedule end.
    - `enabled` boolean — Whether the scheduled job is enabled.
    - `completed` boolean — Whether the scheduled job has completed.
  - `nextLink` string — URL to get the next page of scheduled jobs.

## Other responses

- `default` — An error response received from the IoT Central Service.

---

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