---
title: "List blocked-time presets"
method: GET
path: "/shop/blocked-time-presets"
tags: ["BlockedTimePresets"]
---

# List blocked-time presets

`GET /shop/blocked-time-presets`

Returns a paginated list of `BlockedTimePreset`s at the given
site, alphabetised by name. Use this to populate the preset
picker in the operator calendar UI.

Requires the `RESERVATIONS_VIEW` permission on the site.

## Query parameters

- `site_id` string, required
- `page` integer
- `per_page` integer

## Response `200`

A paginated list of `BlockedTimePreset`s at the site.

- object
  - `data` BlockedTimePreset[], required — The presets on this page, alphabetised by name.
    - `id` string, object-id, required — Unique identifier for the preset.
    - `name` string, required — Display name shown in the preset picker. Plain text only.
    - `duration` integer — Default duration in minutes for a `BlockedTime` created from this preset. Must be at most 1200 (20 hours).
    - `type` 'cleaning' | 'break' | 'meeting' | 'other' — Default block type. Drives the calendar icon.
    - `label` string, nullable — Default short label on the calendar tile. Plain text only.
    - `notes` string, nullable — Default free-form note (plain text).
    - `color` string, nullable — Default hex colour (`#rrggbb`, lower-case) to override the type's default colour.
    - `site_id` string, uuid, required — ID of the site this preset belongs to.
    - `organisation_id` string, uuid, required — ID of the organisation that owns this preset.

## Other responses

- `401` — The user is unauthenticated
- `403` — The authenticated user does not have permission.

---

[API](https://skmtc.dev/try/apis/trybe-api.md) · [All operations](https://skmtc.dev/try/apis/trybe-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/try/trybe-api/revisions/f37f92702da5/schema)