---
title: "List Calendar Blocks"
method: GET
path: "/setup/v1/calendars/{id}/blocks"
tags: ["Calendars"]
---

# List Calendar Blocks

`GET /setup/v1/calendars/{id}/blocks`

Use this endpoint to return a **List of Calendar Blocks** for the requested calendar. A valid **calendar id** is required.

## Path parameters

- `id` string, required

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

Valid response

- CalendarBlockListViewModel
  - `object` string, nullable
  - `url` string, nullable
  - `hasMore` boolean
  - `count` integer
  - `total` integer
  - `data` CalendarBlockViewModel[], nullable
    - `object` string, nullable
    - `id` string, nullable
    - `locationId` string, nullable
    - `calendarId` string, nullable
    - `startDate` string, nullable
    - `endDate` string, nullable
    - `startTime` integer
    - `endTime` integer
    - `reason` string, nullable
    - `repeats` boolean
    - `repeat` RepeatViewModel
      - `frequency` string, nullable
      - `interval` integer
      - `weekdays` string, nullable
      - `monthDay` string, nullable
      - `monthType` string, nullable
    - `deletedStatus` boolean
    - `deletedTime` string, nullable

## Other responses

- `400` — Missing or invalid values in the request
- `401` — Authorization error.
- `404` — Resource was not found

---

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