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

# List all resource schedules

`GET /ext/v2/resource-schedules/`

## Request

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

Returns a list of all resource schedules across all clinics in the organization. The resource schedules are sorted by creation date, with the most recent appearing first.

A **resource schedule** defines the working hours or availability window for a calendar resource (typically a veterinarian or technician). Schedules can be one-off or recurring.

When `use_clinic_hours` is true, the resource follows the clinic's configured business hours and `end_datetime` will be null.

## Query parameters

- `ids` integer[], nullable: When provided, filters to objects with these IDs.
- `ending_before` integer, nullable: A cursor used for pagination. Fetches the page of results ending immediately before the object with the given ID. Cannot be used at the same time as `starting_after`.
- `starting_after` integer, nullable: A cursor used for pagination. Fetches the page of results starting immediately after the given ID. Cannot be used at the same time as `ending_before`.
- `limit` integer: The maximum number of items to return per page.
- `cursor` string, nullable: A cursor token used for pagination. This token contains encoded information about the last seen record in order to continue pagination. Cannot be used with `starting_after` or `ending_before` parameters.
- `modified__gte` string, date-time, nullable: Filters to objects modified on or after this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters.
- `modified__lte` string, date-time, nullable: Filters to objects modified on or before this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters.
- `is_deleted` 'FALSE' | 'TRUE' | 'ALL': When 'FALSE' (default), filters to non-deleted records only. When 'TRUE', filters to soft-deleted records only. When 'ALL', returns both deleted and non-deleted records.
- `clinic_id` integer, nullable: Filter to resource schedules belonging to the clinic with this ID.
- `calendar_resource_id` integer, nullable: Filter to resource schedules for the calendar resource with this ID.

## Response `200`

OK

- ExternalResourceScheduleSchemaList
  - `data` ExternalResourceScheduleSchema[], required: A single page of data contained within this list.
    - `calendar_resource_id` integer, required: The ID of the calendar resource this schedule is for.
    - `clinic_id` integer, required: The ID of the clinic this resource schedule belongs to.
    - `created` string, date-time, required: The datetime this object was created.
    - `deleted` string, date-time, nullable, required: The datetime this record was soft deleted.
    - `end_datetime` string, date-time, nullable, required: ISO 8601 formatted end datetime of the schedule in UTC. Null when use_clinic_hours is true.
    - `id` integer, required: The unique identifier for this resource schedule.
    - `is_deleted` boolean, required: Whether this record is soft deleted or not.
    - `is_recurring` boolean, required: Whether this record follows a recurrence pattern.
    - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field.
    - `recurrence` RecurrenceBreakdownSchema: Structured representation of an RFC 2445 recurrence rule.
      - `days_of_week` string[]: Two-letter day codes. Applicable for WEEKLY and some MONTHLY patterns.
      - `end_after_occurrences` integer, nullable: Total number of occurrences before the recurrence ends, if bounded by count.
      - `end_date` string, date, nullable: ISO 8601 date (YYYY-MM-DD) when the recurrence ends, if bounded by date.
      - `frequency` 'YEARLY' | 'MONTHLY' | 'WEEKLY' | 'DAILY' | 'HOURLY' | 'MINUTELY' | 'SECONDLY', required: The base recurring frequency.
      - `interval` integer, required: The interval between each frequency iteration (e.g., 2 means every 2 weeks for WEEKLY).
    - `rrule` string, nullable: Raw RFC 2445 RRule string, if recurring.
    - `start_datetime` string, date-time, required: ISO 8601 formatted start datetime of the schedule in UTC.
    - `use_clinic_hours` boolean, required: Whether this resource follows the clinic's business hours instead of a custom end time.
  - `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)