---
title: "GET /scheduling-rules"
method: GET
path: "/scheduling-rules"
tags: ["scheduling-rules"]
---

# GET /scheduling-rules

`GET /scheduling-rules`

**Required scope:** automation:rules:read

## Query parameters

- `limit` integer
- `offset` integer
- `ordering` string
- `search` string

## Response `200`

- PaginatedRuleList
  - `count` integer
  - `results` Rule[]
    - `id` string, uuid
    - `version` integer, required
    - `title` string, required
    - `ruleType` 'rrule' | 'grouping' | 'fixed_offset' | 'relative_offset', required — * `rrule` - rrule * `grouping` - grouping * `fixed_offset` - fixed_offset * `relative_offset` - relative_offset
    - `rrule` RRule
      - `freq` 'YEARLY' | 'MONTHLY' | 'WEEKLY' | 'DAILY' | 'HOURLY' | 'MINUTELY' | 'SECONDLY', required
      - `datestart` string, date, required — The recurrence start.
      - `interval` integer — The interval between each freq iteration.
      - `wkst` 'MO' | 'TU' | 'WE' | 'TH' | 'FR' | 'SA' | 'SU' — The week start day.
      - `count` integer — How many occurrences will be generated.
      - `until` string, date-time — Specifying the upper-bound limit of the recurrence.
      - `bysetpos` union — Each given integer will specify an occurrence number, corresponding to the nth occurrence of the rule inside the frequency period
        - integer
        - integer[]
      - `bymonth` union — The months to apply the recurrence to.
        - integer
        - integer[]
      - `bymonthday` union — The month days to apply the recurrence to.
        - integer
        - integer[]
      - `byyearday` union — The year days to apply the recurrence to.
        - integer
        - integer[]
      - `byeaster` union — Each integer will define an offset from the Easter Sunday. Passing the offset 0 to byeaster will yield the Easter Sunday itself.
        - integer
        - integer[]
      - `byweekno` union — The week numbers to apply the recurrence to.
        - integer
        - integer[]
      - `byweekday` string[] — Define the weekdays where the recurrence will be applied.
      - `byhour` union — The hours to apply the recurrence to.
        - integer
        - integer[]
      - `byminute` union — The minutes to apply the recurrence to.
        - integer
        - integer[]
      - `bysecond` union — The seconds to apply the recurrence to.
        - integer
        - integer[]
      - `byworkday` 'WORKING' | 'HOLIDAYS' | 'OFF'
    - `groupingRule` GroupingRule
      - `combine` string[]
      - `intersect` string[]
      - `subtract` string[]
    - `fixedOffsetRule` FixedOffsetRule
      - `rule` string, uuid4, required
      - `offset` number, required — Offset days
    - `relativeOffsetRule` RelativeOffsetRule
      - `direction` 'next' | 'previous', required
      - `sourceRule` string, uuid4, required
      - `targetRule` string, uuid4, required
    - `businessCalendar` string, uuid, nullable
    - `labels` Labels
    - `description` string
    - `modificationInfo` ModificationInfo, required
      - `createdBy` string, uuid, required
      - `createdTime` string, date-time, required
      - `lastModifiedBy` string, uuid, required
      - `lastModifiedTime` string, date-time, required

## Other responses

- `4XX`

---

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