---
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"

## Changes

- **2026-03-29** (v2) `3535cc88f407` — 8 breaking, 7 warning, 9 info
  - the response property `items/additional_notes` became nullable for the status `200`
  - the response property `items/block_colour_override` became nullable for the status `200`
  - the response property `items/is_recording` became nullable for the status `200`
  - the response property `items/number_expected` became nullable for the status `200`
  - …20 more
- **2026-03-25** (v2) `40748de0c299` — 2 info
  - api tag `Booking Endpoints` added
  - api tag `Booking Management Endpoints` removed
- **2026-03-25** (v2) `71bc3de607c7` — 1 info
  - endpoint added
- **2022-05-05** (v2) `95c52cb13f9a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/jammed-org/apis/jammed-bookings-api/changes/bookings/by_dates/get.md)

---

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