v1

latestOpenAPI 3.0.2Jammed Bookings2026-07-147540124.9 KB

Booking Endpoints

Bookings by date range

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

get/bookings/by_dates

Query parameters

fromstring date required

tostring date required

Headers

Authorizationstring required

Response

Bookings for date range

idinteger

codestring

namestring

Customer name

titlestring

Display title, e.g. "John Doe (The Beatles)"

band_namestring

Band/group name, empty string if none

is_recordingboolean nullable

session_namestring nullable

block_colour_overridestring nullable

Hex colour override for the booking block

studio_notesstring nullable

additional_notesstring nullable

number_expectedinteger nullable

startstring

Start datetime as "YYYY-MM-DD HH:mm"

endstring

End datetime as "YYYY-MM-DD HH:mm"

splitstring

Room code — use to match against rooms[].code

room_namestring

Room display name

has_amount_dueboolean

amount_duestring

Formatted currency string e.g. "£1.00"

payments_recievedboolean

Whether any payments have been received (note: API uses this spelling)

regularboolean

incompleteboolean

show_studio_notesboolean

extras_summarystring[]

Array of extra item descriptions (empty array if none)

linkstring

Admin link path e.g. "/admin/bookings/R9XT9J1JFX"

typestring

"booking" or "blocked"

classstring

CSS class for the booking block e.g. "room-l3j5nwp8"

Example response

[
  {
    "start": "2026-03-24 11:41",
    "end": "2026-03-24 12:41"
  }
]