---
title: "Returns historical resource occupancy for a date range and location"
method: GET
path: "/resource_bookings"
tags: ["ResourceBookings"]
---

# Returns historical resource occupancy for a date range and location

`GET /resource_bookings`

## Request

- Base URL: `https://partners-api.mytime.com/api`
- URL: `https://partners-api.mytime.com/api/resource_bookings`
- Auth: API key in header `X-Api-Key`

Returns the bookings each resource (room, equipment, etc.) was used for in a date range,
            optionally narrowed to a single staff member

## Query parameters

- `employee_partner_id` string
- `employee_mytime_id` integer
- `location_partner_id` string
- `location_mytime_id` integer
- `start_date` string, required
- `end_date` string, required

## Headers

- `X-Subdomain` string

## Response `200`

Resource Bookings response

- ResourceBookings[]
  - ResourceBooking[]
    - `resource_name` string
    - `client_name` string
    - `employee_name` string
    - `ticket_status` string
    - `total_services_revenue` number
    - `total_refunds_amount` number
    - `total_environmental_fees_revenue_amount` number
    - `loyalties_prepaid_amount` number
    - `total_gross_revenue_amount` number
    - `resource_mytime_id` integer
    - `appointment_mytime_id` integer
    - `appointment_uuid` string
    - `appointment_datetime` string
    - `appointment_count` integer
    - `ticket_mytime_id` integer
    - `ticket_uuid` string
    - `client_mytime_id` integer
    - `employee_mytime_id` integer

## Other responses

- `401`: Unauthorized
- `422`: Invalid parameters
- `500`: Internal Server Error
- `504`: Gateway Timeout

## Changes

- **2026-09-11** `bbf9e85faf2d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mytime/apis/mytime-partners-api/changes/resource_bookings/get.md)

---

[API](https://skmtc.dev/mytime/apis/mytime-partners-api.md) - [All operations](https://skmtc.dev/mytime/apis/mytime-partners-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mytime/apis/mytime-partners-api/revisions/857eb7db738d?raw)