---
title: "List operating windows"
method: GET
path: "/locations/{id}/operating-windows"
tags: ["Locations"]
---

# List operating windows

`GET /locations/{id}/operating-windows`

## Request

- Base URL: `https://simpledock.ai/api/v1`
- URL: `https://simpledock.ai/api/v1/locations/{id}/operating-windows`
- Auth: HTTP bearer

List a location's weekly operating hours and any one-off blocked windows (holidays, maintenance). Slots are only ever offered inside an operating window and outside every blocked window.

## Path parameters

- `id` string, required

## Response `200`

Success

- object
  - `data` OperatingWindows, required
    - `operatingWindows` object[]
      - `id` string
      - `dayOfWeek` integer
      - `openTime` string
      - `closeTime` string
    - `blockedWindows` object[]
      - `id` string
      - `startTime` string, date-time
      - `endTime` string, date-time
      - `reason` string, nullable

## Other responses

- `401`: Unauthorized — missing, invalid, or expired key
- `402`: Payment required — a Pro feature or a Free plan limit
- `403`: Forbidden — key is missing the required scope
- `404`: Not found
- `429`: Rate limited — slow down and retry after Retry-After

---

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