---
title: "Get a drift detection schedule"
method: GET
path: "/drift-detection-schedules/{drift_detection_schedule}"
tags: ["drift-detection-schedules"]
---

# Get a drift detection schedule

`GET /drift-detection-schedules/{drift_detection_schedule}`

## Request

- Base URL: `https://example.scalr.io/api/iacp/v3`
- URL: `https://example.scalr.io/api/iacp/v3/drift-detection-schedules/{drift_detection_schedule}`
- Auth: HTTP bearer

## Path parameters

- `drift_detection_schedule` string, required

## Response `200`

Success.

- DriftDetectionScheduleDocument: JSON:API Document. see: https://jsonapi.org/format/#document-structure
  - `data` DriftDetectionSchedule
    - `attributes` object, required
      - `run-mode` 'refresh-only' | 'plan': The run mode of the drift detection.
      - `schedule` 'daily' | 'weekly', required: The schedule of the drift detection.
      - `time-window` '00:00-04:00' | '04:00-08:00' | '08:00-12:00' | '12:00-16:00' | '16:00-20:00' | '20:00-24:00', nullable: Preferred UTC time window within which drift checks are scheduled.
      - `workspace-filters` object: The workspace filters to monitor for drift.
        - `environment-types` string[]
        - `name-patterns` string[]
        - `tags` string[]
    - `id` string
    - `links` object
    - `relationships` object, required
      - `environment` object, required: The environment this drift detection schedule belongs to.
        - `data` object, required
          - `id` string, required
          - `type` 'environments' | '', required
    - `type` 'drift-detection-schedule', required
  - `included` object[]
  - `meta` object

## Other responses

- `404`: drift_detection_schedule not found, or user unauthorized to perform action.
- `4XX`: Client error.
- `5XX`: Server error.

## Changes

- **2026-11-03** `d3e1dc85657a`: 1 info
  - added the optional property `data/attributes/time-window` to the response with the `200` status

[Operation history](https://skmtc.dev/scalr/apis/scalr-iacp-api/changes/drift-detection-schedules/:drift_detection_schedule/get.md)

---

[API](https://skmtc.dev/scalr/apis/scalr-iacp-api.md) - [All operations](https://skmtc.dev/scalr/apis/scalr-iacp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scalr/apis/scalr-iacp-api/revisions/d3e1dc85657a?raw)