---
title: "Get Occupancy By Range"
method: GET
path: "/api/room-availabilities/occupancy/by-range"
tags: ["rooms"]
---

# Get Occupancy By Range

`GET /api/room-availabilities/occupancy/by-range`

## Query parameters

- `start` string, date-time, required
- `end` string, date-time, required

## Response `200`

Successful Response

- RoomAvailabilityOccupancyResponse[]
  - `id` string, uuid, required
  - `room_id` string, uuid, required
  - `start_time` string, date-time, required
  - `end_time` string, date-time, required
  - `is_available` boolean, required
  - `availability_id` string, uuid, nullable
  - `operator_id` string, uuid, nullable
  - `appointment_id` string, uuid, nullable
  - `notes` string, nullable
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable
  - `operator` RoomAvailabilityOperatorDetailsResponse
    - `id` string, uuid, required
    - `user` RoomAvailabilityUserDetailsResponse
      - `id` string, uuid, required
      - `first_name` string, nullable
      - `last_name` string, nullable
  - `appointment` RoomAvailabilityAppointmentDetailsResponse
    - `id` string, uuid, required
    - `patient` RoomAvailabilityPatientDetailsResponse
      - `id` string, uuid, required
      - `user` RoomAvailabilityUserDetailsResponse
        - `id` string, uuid, required
        - `first_name` string, nullable
        - `last_name` string, nullable
  - `is_occupied` boolean, required
  - `is_deletable` boolean, required
  - `booked_experts_count` integer, required
  - `booked_experts` RoomAvailabilityBookedExpertResponse[]
    - `id` string, uuid, required
    - `first_name` string, nullable
    - `last_name` string, nullable
  - `linked_location_type` string, nullable — Linked availability patient-facing location type
  - `is_joint_appointment` boolean — Whether the appointment occupying the slot is a joint meeting
  - `appointment_experts` RoomAvailabilityBookedExpertResponse[] — Experts of the appointment occupying the slot: both legs when it is joint
    - `id` string, uuid, required
    - `first_name` string, nullable
    - `last_name` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/corabea/apis/corabea-api.md) · [All operations](https://skmtc.dev/corabea/apis/corabea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corabea/corabea-api/revisions/13c1bce1bdc4/schema)