---
title: "List resource schedule blocks"
method: GET
path: "/ext/v2/resource-schedule-blocks/"
tags: ["Scheduler"]
---

# List resource schedule blocks

`GET /ext/v2/resource-schedule-blocks/`

## Request

- Base URL: `https://connect.vetcove.com`
- URL: `https://connect.vetcove.com/ext/v2/resource-schedule-blocks/`
- Auth: HTTP bearer

Returns the availability schedule blocks for calendar resources within a date range. The blocks are sorted by datetime in ascending order.

A **resource schedule block** represents a time window during which a calendar resource (e.g., a veterinarian) is available for appointments. Use this endpoint to determine when resources are available for scheduling.

## Query parameters

- `calendar_id` integer, required: Required. The ID of the calendar to fetch resource schedule blocks for
- `start_datetime__gte` string, required: Required. Start date for fetching resource schedule blocks. This will be translated to a datetime representing the start of the day in the clinic's timezone. Must be no more than 30 days before `end_datetime__lte`. Format: YYYY-MM-DD
- `end_datetime__lte` string, required: Required. End date for fetching resource schedule blocks. This will be translated to a datetime representing the end of the day in the clinic's timezone. Must be no more than 30 days after `start_datetime__gte`. Format: YYYY-MM-DD
- `calendar_resource_id` integer, nullable: Optional. The ID of the calendar resource to fetch event blocks for

## Response `200`

OK

- ExternalResourceScheduleBlockSchemaList
  - `data` ExternalResourceScheduleBlockSchema[], required: A single page of data contained within this list.
    - `resource_id` integer, required: The ID of the resource this schedule block belongs to.
    - `time_blocks` ResourceScheduleBlockTimeRange[], required: The time blocks of this schedule block.
      - `end_datetime` string, date-time, required: The ending datetime of this schedule block, in UTC.
      - `start_datetime` string, date-time, required: The starting datetime of this schedule block, in UTC.
  - `has_more` boolean: Whether there are more pages or data in this list.
  - `next_page` string, required: A URL linking to the next page of this list.
  - `type` string: Type of this object. Always `list`.

---

[API](https://skmtc.dev/vetcove/apis/ninjaapi.md) - [All operations](https://skmtc.dev/vetcove/apis/ninjaapi/llms.txt) - [OpenAPI document](https://skmtc.dev/vetcove/apis/ninjaapi/revisions/4ceaed956e15?raw)