> ## Documentation Index
> Fetch the complete documentation index at: https://developer.vetcove.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch a calendar event

> Fetches a calendar event by its ID.

A **calendar event** represents a non-appointment block on a clinic's calendar (e.g., a staff meeting, lunch break, out-of-office, or clinic closure). Calendar events can be one-off or recurring, and may block appointment scheduling depending on configuration.

Events are scoped to specific calendar resources (providers) or can apply to all resources on a calendar. If an event is an exception to a recurring series, it references the parent recurring event.



## OpenAPI

````yaml get /ext/v2/calendar-events/{calendar_event_id}/
openapi: 3.1.0
info:
  description: ''
  title: NinjaAPI
  version: 2.0.0
servers:
  - url: https://connect.vetcove.com/
security: []
paths:
  /ext/v2/calendar-events/{calendar_event_id}/:
    get:
      tags:
        - Scheduler
      summary: Fetch a calendar event
      description: >-
        Fetches a calendar event by its ID.


        A **calendar event** represents a non-appointment block on a clinic's
        calendar (e.g., a staff meeting, lunch break, out-of-office, or clinic
        closure). Calendar events can be one-off or recurring, and may block
        appointment scheduling depending on configuration.


        Events are scoped to specific calendar resources (providers) or can
        apply to all resources on a calendar. If an event is an exception to a
        recurring series, it references the parent recurring event.
      operationId: calendar_events_get
      parameters:
        - description: The ID of the calendar event to fetch.
          in: path
          name: calendar_event_id
          required: true
          schema:
            description: The ID of the calendar event to fetch.
            title: Calendar Event Id
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalCalendarEventSchema'
          description: OK
      security:
        - ExternalAPIAuth: []
components:
  schemas:
    ExternalCalendarEventSchema:
      properties:
        calendar_resource_ids:
          description: The IDs of the calendar resources this event is assigned to.
          items:
            type: integer
          title: Calendar Resource Ids
          type: array
        clinic_id:
          description: The ID of the clinic this calendar event belongs to.
          title: Clinic Id
          type: integer
        created:
          description: The datetime this object was created.
          format: date-time
          title: Created
          type: string
        deleted:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: The datetime this record was soft deleted.
          title: Deleted
        description:
          anyOf:
            - type: string
            - type: 'null'
          description: Plain-text description of the event.
          title: Description
        duration_minutes:
          description: >-
            Duration of the event in minutes, computed from start and end
            datetimes.
          title: Duration Minutes
          type: integer
        end_datetime:
          description: ISO 8601 formatted end datetime of the event in UTC.
          format: date-time
          title: End Datetime
          type: string
        id:
          description: The unique identifier for this calendar event.
          title: Id
          type: integer
        is_applicable_to_all_resources:
          description: Whether this event applies to all resources on the calendar.
          title: Is Applicable To All Resources
          type: boolean
        is_deleted:
          description: Whether this record is soft deleted or not.
          title: Is Deleted
          type: boolean
        is_recurring:
          description: Whether this record follows a recurrence pattern.
          title: Is Recurring
          type: boolean
        kind_id:
          description: The ID of the calendar event kind.
          title: Kind Id
          type: integer
        kind_slug:
          description: The slug identifier of the calendar event kind.
          title: Kind Slug
          type: string
        modified:
          description: >-
            The datetime this object was last modified; changes to related
            entities will not update this field.
          format: date-time
          title: Modified
          type: string
        recurrence:
          anyOf:
            - $ref: '#/components/schemas/RecurrenceBreakdownSchema'
            - type: 'null'
          description: Structured recurrence pattern, if recurring.
        recurrence_excluded_datetimes:
          description: Specific datetimes excluded from the recurrence pattern.
          items:
            format: date-time
            type: string
          title: Recurrence Excluded Datetimes
          type: array
        recurring_event_id:
          anyOf:
            - type: integer
            - type: 'null'
          description: >-
            If this event is an exception to a recurring series, the ID of the
            parent recurring event.
          title: Recurring Event Id
        rrule:
          anyOf:
            - type: string
            - type: 'null'
          description: Raw RFC 2445 RRule string, if recurring.
          title: Rrule
        should_block_appointments:
          description: >-
            Whether this event prevents appointments from being scheduled during
            its time window.
          title: Should Block Appointments
          type: boolean
        start_datetime:
          description: ISO 8601 formatted start datetime of the event in UTC.
          format: date-time
          title: Start Datetime
          type: string
      required:
        - created
        - modified
        - is_deleted
        - deleted
        - is_recurring
        - id
        - clinic_id
        - is_applicable_to_all_resources
        - kind_id
        - kind_slug
        - description
        - should_block_appointments
        - start_datetime
        - end_datetime
        - duration_minutes
      title: ExternalCalendarEventSchema
      type: object
    RecurrenceBreakdownSchema:
      description: Structured representation of an RFC 2445 recurrence rule.
      properties:
        days_of_week:
          description: >-
            Two-letter day codes. Applicable for WEEKLY and some MONTHLY
            patterns.
          items:
            enum:
              - MO
              - TU
              - WE
              - TH
              - FR
              - SA
              - SU
            type: string
          title: Days Of Week
          type: array
        end_after_occurrences:
          anyOf:
            - type: integer
            - type: 'null'
          description: >-
            Total number of occurrences before the recurrence ends, if bounded
            by count.
          title: End After Occurrences
        end_date:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          description: >-
            ISO 8601 date (YYYY-MM-DD) when the recurrence ends, if bounded by
            date.
          title: End Date
        frequency:
          description: The base recurring frequency.
          enum:
            - YEARLY
            - MONTHLY
            - WEEKLY
            - DAILY
            - HOURLY
            - MINUTELY
            - SECONDLY
          title: Frequency
          type: string
        interval:
          description: >-
            The interval between each frequency iteration (e.g., 2 means every 2
            weeks for WEEKLY).
          title: Interval
          type: integer
      required:
        - frequency
        - interval
      title: RecurrenceBreakdownSchema
      type: object
  securitySchemes:
    ExternalAPIAuth:
      scheme: bearer
      type: http

````