---
title: "List all calendar kind preferences"
method: GET
path: "/ext/v2/calendar-kind-preferences/"
tags: ["Scheduler"]
---

# List all calendar kind preferences

`GET /ext/v2/calendar-kind-preferences/`

## Request

- Base URL: `https://connect.vetcove.com`
- URL: `https://connect.vetcove.com/ext/v2/calendar-kind-preferences/`
- Auth: HTTP bearer

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

A **calendar kind preference** links an appointment kind to specific calendar resources, defining which resources can handle which types of appointments. It also controls whether that appointment kind is bookable by pet parents online.

## 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.
- `clinic_id` integer, nullable: The ID of the clinic to fetch calendar kind preferences for
- `calendar_id` integer, nullable: The ID of the calendar to fetch calendar kind preferences for
- `calendar_resource_id` integer, nullable: The ID of the calendar resource to fetch calendar kind preferences for
- `appointment_kind_id` integer, nullable: The ID of the appointment kind to fetch calendar kind preferences for
- `is_client_bookable` boolean, nullable: Whether the calendar kind preference is client bookable
- `species` string[]: The species to fetch calendar kind preferences for, this is filtering across the resources allowed species list

## Response `200`

OK

- CalendarKindPreferenceList
  - `data` ExternalCalendarKindPreferenceSchema[], required: A single page of data contained within this list.
    - `appointment_kind_id` integer, required: The ID of the appointment kind this preference is for.
    - `calendar_id` integer, required: The ID of the calendar this preference is for.
    - `calendar_resource_ids` integer[]: Calendar resources this appointment kind is limited to.
    - `clinic_id` integer, required: The ID of the clinic this preference belongs to.
    - `created` string, date-time, required: The datetime this object was created.
    - `default_duration_minutes` 10 | 15 | 20 | 30 | 40 | 45 | 50 | 60, required
    - `id` integer, required: The unique identifier for this calendar kind preference object.
    - `is_client_bookable` boolean, required: Whether clients can book this appointment kind.
    - `min_hours_before_booking` integer, required: The minimum number of hours in advance appointments can be booked, for this appointment kind and calendar.
    - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field.
  - `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)