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

Changes

Changed in 4 of the 32 revisions of this API.9712

Mar 29, 2026v23535cc88f407879See the full diff
- ▲
  the response property items/additional_notes became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property items/block_colour_override became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property items/is_recording became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property items/number_expected became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property items/session_name became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property items/studio_notes became nullable for the status 200
  response-property-became-nullable
- ▲
  the items/amount_due response's property type/format changed from integer/ to string/ for status 200
  response-property-type-changed
- ▲
  the items/extras_summary response's property type/format changed from string/ to array/ for status 200
  response-property-type-changed
- ●
  removed the optional property items/cancelled from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property items/customer from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property items/end_at from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property items/end_time from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property items/room from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property items/start_at from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property items/start_time from the response with the 200 status
  response-optional-property-removed
- ○
  added the optional property items/class to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property items/end to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property items/link to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property items/payments_recieved to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property items/room_name to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property items/show_studio_notes to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property items/split to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property items/start to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property items/type to the response with the 200 status
  response-optional-property-added
Mar 25, 2026v240748de0c2992See the full diff
- ○
  api tag Booking Endpoints added
  api-tag-added
- ○
  api tag Booking Management Endpoints removed
  api-tag-removed
Mar 25, 2026v271bc3de607c71See the full diff
- ○
  endpoint added
  endpoint-added
May 5, 2022v295c52cb13f9a1See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 29 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history