---
title: "List Synthetics downtimes"
method: GET
path: "/api/v2/synthetics/downtimes"
tags: ["Synthetics"]
---

# List Synthetics downtimes

`GET /api/v2/synthetics/downtimes`

Get a list of all Synthetics downtimes for your organization.

## Query parameters

- `filter[test_ids]` string
- `filter[active]` string

## Response `200`

OK

- SyntheticsDowntimesResponse — Response containing a list of Synthetics downtimes.
  - `data` SyntheticsDowntimeData[], required — List of Synthetics downtime objects.
    - `attributes` SyntheticsDowntimeDataAttributesResponse, required — Attributes of a Synthetics downtime response object.
      - `createdAt` string, date-time, required — The timestamp when the downtime was created.
      - `createdBy` string, required — The UUID of the user who created the downtime.
      - `createdByName` string, required — The display name of the user who created the downtime.
      - `description` string, required — The description of the downtime.
      - `isEnabled` boolean, required — Whether the downtime is enabled.
      - `name` string, required — The name of the downtime.
      - `tags` string[], required — List of tags associated with a Synthetics downtime.
      - `testIds` string[], required — List of Synthetics test public IDs associated with a downtime.
      - `timeSlots` SyntheticsDowntimeTimeSlotResponse[], required — List of time slots in a Synthetics downtime response.
        - `duration` integer, required — The duration of the time slot in seconds.
        - `id` string, required — The unique identifier of the time slot.
        - `name` string — The label for the time slot.
        - `recurrence` SyntheticsDowntimeTimeSlotRecurrenceResponse — Recurrence settings returned in a Synthetics downtime time slot response.
          - `frequency` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY', required — The recurrence frequency of a Synthetics downtime time slot.
          - `interval` integer, required — The interval between recurrences, relative to the frequency.
          - `until` SyntheticsDowntimeTimeSlotDate — A specific date and time used to define the start or end of a Synthetics downtime time slot.
            - `day` integer, required — The day component of the date (1-31).
            - `hour` integer, required — The hour component of the time (0-23).
            - `minute` integer, required — The minute component of the time (0-59).
            - `month` integer, required — The month component of the date (1-12).
            - `year` integer, required — The year component of the date.
          - `weekdayPositions` SyntheticsDowntimeWeekdayPosition[] — Positions of the weekdays within a month for a monthly Synthetics downtime recurrence. Used in combination with `weekdays` to schedule occurrences such as "the first Monday of the month".
          - `weekdays` SyntheticsDowntimeWeekday[], required — Days of the week for a Synthetics downtime recurrence schedule.
        - `start` SyntheticsDowntimeTimeSlotDate, required — A specific date and time used to define the start or end of a Synthetics downtime time slot.
          - `day` integer, required — The day component of the date (1-31).
          - `hour` integer, required — The hour component of the time (0-23).
          - `minute` integer, required — The minute component of the time (0-59).
          - `month` integer, required — The month component of the date (1-12).
          - `year` integer, required — The year component of the date.
        - `timezone` string, required — The IANA timezone name for the time slot.
      - `updatedAt` string, date-time, required — The timestamp when the downtime was last updated.
      - `updatedBy` string, required — The UUID of the user who last updated the downtime.
      - `updatedByName` string, required — The display name of the user who last updated the downtime.
    - `id` string, required — The unique identifier of the downtime.
    - `type` 'downtime', required — The resource type for a Synthetics downtime.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)