> ## 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.

# List all resource schedule exceptions

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

A **resource schedule exception** represents a one-off override to a resource's regular schedule. Exceptions can mark a resource as unavailable for the day, set custom hours, or indicate that the resource should use the clinic's hours for that day.

Unlike resource schedules, exceptions are always one-off (non-recurring).



## OpenAPI

````yaml get /ext/v2/resource-schedule-exceptions/
openapi: 3.1.0
info:
  description: ''
  title: NinjaAPI
  version: 2.0.0
servers:
  - url: https://connect.vetcove.com/
security: []
paths:
  /ext/v2/resource-schedule-exceptions/:
    get:
      tags:
        - Scheduler
      summary: List all resource schedule exceptions
      description: >-
        Returns a list of all resource schedule exceptions across all clinics in
        the organization. The resource schedule exceptions are sorted by
        creation date, with the most recent appearing first.


        A **resource schedule exception** represents a one-off override to a
        resource's regular schedule. Exceptions can mark a resource as
        unavailable for the day, set custom hours, or indicate that the resource
        should use the clinic's hours for that day.


        Unlike resource schedules, exceptions are always one-off
        (non-recurring).
      operationId: resource_schedule_exceptions_list
      parameters:
        - description: When provided, filters to objects with these IDs.
          in: query
          name: ids
          required: false
          schema:
            anyOf:
              - items:
                  type: integer
                type: array
              - type: 'null'
            description: When provided, filters to objects with these IDs.
            title: Ids
        - description: >-
            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`.
          in: query
          name: ending_before
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: >-
              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`.
            title: Ending Before
        - description: >-
            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`.
          in: query
          name: starting_after
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: >-
              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`.
            title: Starting After
        - description: The maximum number of items to return per page.
          in: query
          name: limit
          required: false
          schema:
            default: 10
            description: The maximum number of items to return per page.
            maximum: 100
            minimum: 1
            title: Limit
            type: integer
        - description: >-
            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.
          in: query
          name: cursor
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              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.
            title: Cursor
        - description: >-
            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.
          in: query
          name: modified__gte
          required: false
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: 'null'
            description: >-
              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.
            title: Modified  Gte
        - description: >-
            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.
          in: query
          name: modified__lte
          required: false
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: 'null'
            description: >-
              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.
            title: Modified  Lte
        - description: >-
            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.
          in: query
          name: is_deleted
          required: false
          schema:
            allOf:
              - enum:
                  - 'FALSE'
                  - 'TRUE'
                  - ALL
                title: DeletedFilterOption
                type: string
            default: 'FALSE'
            description: >-
              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.
        - description: >-
            Filter to resource schedule exceptions belonging to the clinic with
            this ID.
          in: query
          name: clinic_id
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: >-
              Filter to resource schedule exceptions belonging to the clinic
              with this ID.
            title: Clinic Id
        - description: >-
            Filter to resource schedule exceptions for the calendar resource
            with this ID.
          in: query
          name: calendar_resource_id
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: >-
              Filter to resource schedule exceptions for the calendar resource
              with this ID.
            title: Calendar Resource Id
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/ExternalResourceScheduleExceptionSchemaList
          description: OK
      security:
        - ExternalAPIAuth: []
components:
  schemas:
    ExternalResourceScheduleExceptionSchemaList:
      properties:
        data:
          description: A single page of data contained within this list.
          items:
            $ref: '#/components/schemas/ExternalResourceScheduleExceptionSchema'
          title: Data
          type: array
        has_more:
          default: false
          description: Whether there are more pages or data in this list.
          title: Has More
          type: boolean
        next_page:
          description: A URL linking to the next page of this list.
          title: Next Page
          type: string
        type:
          default: list
          description: Type of this object. Always `list`.
          title: Type
          type: string
      required:
        - data
        - next_page
      title: ExternalResourceScheduleExceptionSchemaList
      type: object
    ExternalResourceScheduleExceptionSchema:
      properties:
        calendar_resource_id:
          description: The ID of the calendar resource this exception is for.
          title: Calendar Resource Id
          type: integer
        clinic_id:
          description: The ID of the clinic this schedule exception 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
        end_datetime:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: >-
            ISO 8601 formatted end datetime of the exception in UTC. Null when
            is_unavailable or use_clinic_hours is true.
          title: End Datetime
        id:
          description: The unique identifier for this schedule exception.
          title: Id
          type: integer
        is_deleted:
          description: Whether this record is soft deleted or not.
          title: Is Deleted
          type: boolean
        is_unavailable:
          description: Whether the resource is entirely unavailable during this exception.
          title: Is Unavailable
          type: boolean
        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
        start_datetime:
          description: ISO 8601 formatted start datetime of the exception in UTC.
          format: date-time
          title: Start Datetime
          type: string
        use_clinic_hours:
          description: >-
            Whether the resource should use the clinic's business hours for this
            exception day.
          title: Use Clinic Hours
          type: boolean
      required:
        - created
        - modified
        - is_deleted
        - deleted
        - id
        - clinic_id
        - calendar_resource_id
        - start_datetime
        - end_datetime
        - is_unavailable
        - use_clinic_hours
      title: ExternalResourceScheduleExceptionSchema
      type: object
  securitySchemes:
    ExternalAPIAuth:
      scheme: bearer
      type: http

````