---
title: "Fetch a calendar"
method: GET
path: "/ext/v2/calendars/{calendar_id}/"
tags: ["Scheduler"]
---

# Fetch a calendar

`GET /ext/v2/calendars/{calendar_id}/`

## Request

- Base URL: `https://connect.vetcove.com`
- URL: `https://connect.vetcove.com/ext/v2/calendars/{calendar_id}/`
- Auth: HTTP bearer

Fetches a calendar by its ID.

A **calendar** represents a scheduling calendar for a specific clinic. Each clinic typically has one calendar that contains all of its appointments, resources (veterinarians/staff), and rooms.

## Path parameters

- `calendar_id` integer, required: The ID of the calendar to fetch.

## Response `200`

OK

- ExternalCalendarDetailSchema: Detailed information about a calendar
  - `allowed_appointment_kinds` integer[], required: List of appointment kind IDs that can be booked on this calendar.
  - `block_increment_minutes` 10 | 15 | 20 | 30 | 40 | 45 | 50 | 60, required
  - `clinic_id` integer, required: The ID of the clinic this calendar belongs to.
  - `default_duration_minutes` 10 | 15 | 20 | 30 | 40 | 45 | 50 | 60, required
  - `id` integer, required: The unique identifier for the calendar.
  - `is_client_booking_enabled` boolean, required: Whether client booking is enabled for this calendar.
  - `name` string, required: Display name for the calendar.
  - `non_exotic_species` string[], required: List of species that the clinic defines as not exotic.

---

[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)
