---
title: "Bookings by date range"
method: GET
path: "/bookings/by_dates"
tags: ["Booking Endpoints"]
---

# Bookings by date range

`GET /bookings/by_dates`

Returns bookings for a date range, optimized for calendar/schedule display.

## Query parameters

- `from` string, date, required
- `to` string, date, required

## Headers

- `Authorization` string, required

## Response `200`

Bookings for date range

- DashboardBooking[]
  - `id` integer
  - `code` string
  - `name` string — Customer name
  - `title` string — Display title, e.g. "John Doe (The Beatles)"
  - `band_name` string — Band/group name, empty string if none
  - `is_recording` boolean, nullable
  - `session_name` string, nullable
  - `block_colour_override` string, nullable — Hex colour override for the booking block
  - `studio_notes` string, nullable
  - `additional_notes` string, nullable
  - `number_expected` integer, nullable
  - `start` string — Start datetime as "YYYY-MM-DD HH:mm"
  - `end` string — End datetime as "YYYY-MM-DD HH:mm"
  - `split` string — Room code — use to match against rooms[].code
  - `room_name` string — Room display name
  - `has_amount_due` boolean
  - `amount_due` string — Formatted currency string e.g. "£1.00"
  - `payments_recieved` boolean — Whether any payments have been received (note: API uses this spelling)
  - `regular` boolean
  - `incomplete` boolean
  - `show_studio_notes` boolean
  - `extras_summary` string[] — Array of extra item descriptions (empty array if none)
  - `link` string — Admin link path e.g. "/admin/bookings/R9XT9J1JFX"
  - `type` string — "booking" or "blocked"
  - `class` string — CSS class for the booking block e.g. "room-l3j5nwp8"

---

[API](https://skmtc.net/jammed-org/apis/jammed-bookings-api.md) · [All operations](https://skmtc.net/jammed-org/apis/jammed-bookings-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jammed-org/jammed-bookings-api/revisions/3fc6a6f91b06/schema)