Changelog
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[6.0.0] - 2026-02-26

Added

VenuePreorders schema: new wrapper object containing packages and menus arrays
ProductAvailabilityRules schema: availability rules for a product grouped by source (weekly, exceptions, rules)
WeeklyRule schema: weekly booking schedule, one entry per day of the week
RuleException schema: date-specific availability exceptions imposed by the TMS
AvailabilityRule schema: operator-defined availability rules per partner
AvailabilityRuleType enum: date_range, recurring, time_based, specific_dates, specific_dates_with_time, date_range_with_time, recurring_with_time
RuleDataBase and all discriminated subtypes: DateRangeRuleData, RecurringRuleData, TimeBasedRuleData, SpecificDatesRuleData, SpecificDatesWithTimeRuleData, DateRangeWithTimeRuleData, RecurringWithTimeRuleData
PreorderContainer schema: container for all preorder items (packages → PreorderPackageRequest, menus → PreorderMenuRequestV2)
MenuItemOption schema: configurable option for a menu item (field value)
MenuItem: added fields name, price, description, diet_types, allergens, configurable_options, type, subType, displayOrder
MenuItemSelection: added field options (array of MenuItemOption)
Booking.preorders.menus: added field submitted (enum: pre / post)
PATCH /venues/bookings/{bookingId}: new endpoint for partial booking updates via JSON Patch (RFC 6902)
JsonPatchOperation schema supporting add, remove, replace operations
Product: added field preOrderRequired (boolean)

Changed

MenuItem.subGroupName renamed to subType
POST /venues/{compositeId}/booking response 201: changed from BookingResponse to full Booking schema
Terminology updated throughout: "RMS (Restaurant Management System)" → "TMS (Table Management System)"
Security schemes consolidated: staging environments (Staging, SandboxStaging, SandboxProduction) removed; only Production and Sandbox remain
Servers list reduced to Production (https://api.bookabletech.com) and Sandbox (https://api-sandbox.bookabletech.com)

Removed

Venue.packages (top-level array) — replaced by Venue.preorders.packages
Venue.menus (top-level array) — replaced by Venue.preorders.menus
BookingRequest.preorderPackages — replaced by BookingRequest.preorders.packages
BookingRequest.preorderMenus — replaced by BookingRequest.preorders.menus
Sandbox Staging server https://api-sandbox-staging.bookabletech.com

[5.1.0] - 2026-02-09

Added

compositeId query filter to the GET /venues/bookings endpoint.

[5.0.0] - 2026-01-27

Changed

BREAKING CHANGE in the following endpoints:

GET /venues/bookings
GET /venues/bookings/{bookingId}
PUT /venues/bookings/{bookingId}
Changed:
- company field is now venueGroupName
- productType field is now productName
Removed:
- cursor query parameter from GET /venues/bookings
- cursor field from response from GET /venues/bookings
Added: Standard pagination parameters in GET /venues/bookings:
- pageNumber (integer, default: 1, min: 1) - The page index to return
- pageSize (integer, default: 20, min: 1, max: 100) - Items per pageNumber
- meta object with pagination metadata:
```
"meta": {
      "currentPage": 1,
      "pageSize": 20,
      "totalItems": 26,
      "totalPages": 2
  }
```

Migration Guide:

  - GET /venues/bookings?cursor=abc123
  + GET /venues/bookings?pageNumber=1&pageSize=20

GET /venues/{compositeId}/availability
Added: preOrderItems

[4.12.0] - 2026-01-19

Added

venueGroupName field on venue object in GET /venues and GET /venues/{venueId} endpoints.

[4.11.1] - 2026-01-13

Changed

Remove constraints on bookingRules.

[4.10.0] - 2025-12-05

Changed

X-Booking-Source header in POST venues/bookings is now an enumeration.

[4.9.0] - 2025-12-03

Added

Added sorting capabilities to GET /venues endpoint:
New Query Parameters
- sortBy (optional): Field to sort results by
  - default - Sort by composite ID (venue_group_id, rms_id, venue_id)
  - name - Sort alphabetically by venue name
  - city - Sort by city name, then venue name
  - area - Sort by area, then venue name
  - venueGroup - Sort by venue group name (requires venueGroupName filter)
  - relevance - Sort by semantic similarity using vector embeddings (requires embedding filters)
- sortDirection (optional): Sort direction
  - ASC - Ascending (A-Z, 0-9, most to least similar)
  - DESC - Descending (Z-A, 9-0, least to most similar)

[4.8.0] - 2025-12-01

Added

Operator Booking Id and Partner Booking Id support to GET venues/bookings by operatorBookingId and partnerBookingId fields
Partner Booking Id support to POST venues/bookings bypartnerBookingId field

Changed

Reference field is deprecated in GET venues/bookings ; use operatorBookingId instead.

[4.7.0] - 2025-10-13

Added

Booking Overrides support to GET venues and GET venues\{venueId} by bookingOverrides field
Operator availability rule support to GET venues and GET venues\{venueId} by operatorAvailabilityRules field

[4.6.0] - 2025-10-13

Added

Preorders support to GET venues/bookings by preorders field
Preorder menus support to GET venues/bookings by preorderMenus field

[4.5.0] - 2025-09-29

Added

Possibility to filter by date and time within the GET /venues endpoint.

[4.4.0] - 2025-09-26

Added

X-Booking-Source header which identifies the source or channel through which the booking was created.

[4.3.0] - 2025-09-22

Added

X-Partner-Reference header is now mandatory on all the endpoints for Bookable Agent clients.

[4.2.0] - 2025-09-15

Added

noAvailabilityAction support to GET venues/:venueId/availability
autoConfirmRule support to GET venues/:venueId/availability

[4.1.0] - 2025-09-08

Added

Preorder menu support to GET venues and GET venues/:venueId by menus field
Preorder menu support to POST venues/:venueId/booking by preorderMenus field
Preorder menu email triggering on submit booking
Preorder menu support to GET venues/bookings/:bookingId by preorderMenus field

Removed

packageId field on POST venues/:venueId/booking request

[4.0.0] - 2025-09-02

Added

BREAKING CHANGE: Booking PUT request now requires compositeId

Removed

GET /venues/products/{compositeId} endpoint

[3.4.0] - 2025-08-20

Added

Venue packages detail by packages
Booking POST request now accepts packageId
Booking POST request now accepts preorders

[3.3.0] - 2025-08-13

Added

Endpoint to get a venue product detail by compositeId

[3.2.0] - 2025-08-12

Changed

Venue Schema Fields: Deprecated is_active and created_at fields in venue responses
Booking POST request now accepts null value for duration field

[3.1.0] - 2025-07-30

Added

Booking POST request includes admin_notes, comments & labels field

[3.0.0] - 2025-07-29

Added

Standardized error handling across all endpoints

Changed

BREAKING CHANGE: Modified venue composition - products are now contained within the venue structure

[2.3.0] - 2025-07-02

Added

X-Partner-Reference header for Bookable Agents. The header specifies the partner reference for whom the booking is being made.

[2.2.0] - 2025-06-06

Added

Endpoint to update an existing booking by its unique ID
Endpoint to cancel a booking by its unique ID

[2.1.0] - 2025-05-30

Added

Endpoint to retrieve a paginated list of bookings
Endpoint to retrieve a specific booking by its unique ID

[2.0.0] - 2025-05-16

Added

Support for paginated venue listings

Changed

Rename shut into bookingCutoff

[1.2.0] - 2025-05-14

Added

bookingRules: Insert booking rules on Venue to show information about the opening/ close time, max min number of people, and other

[1.1.1] - 2025-05-08

Fixed

Validation on require field (#TS-948)

[1.1.0] - 2025-05-02

Unified API

Add the unified api

Added

VenueId: Introduced the concept of composite Id to manage id into the system
type into avalability response: Specifies how an operators time slot can be handled.
type into revervation request
product_name: the name of product offer from venue

ChangelogCopyCopy for LLMCopy page as Markdown for LLMsView as MarkdownOpen this page as MarkdownOpen in ChatGPTGet insights from ChatGPTOpen in ClaudeGet insights from Claude

[6.0.0] - 2026-02-26

Added

Changed

Removed

[5.1.0] - 2026-02-09

Added

[5.0.0] - 2026-01-27

Changed

[4.12.0] - 2026-01-19

Added

[4.11.1] - 2026-01-13

Changed

[4.10.0] - 2025-12-05

Changed

[4.9.0] - 2025-12-03

Added

[4.8.0] - 2025-12-01

Added

Changed

[4.7.0] - 2025-10-13

Added

[4.6.0] - 2025-10-13

Added

[4.5.0] - 2025-09-29

Added

[4.4.0] - 2025-09-26

Added

[4.3.0] - 2025-09-22

Added

[4.2.0] - 2025-09-15

Added

[4.1.0] - 2025-09-08

Added

Removed

[4.0.0] - 2025-09-02

Added

Removed

[3.4.0] - 2025-08-20

Added

[3.3.0] - 2025-08-13

Added

[3.2.0] - 2025-08-12

Changed

[3.1.0] - 2025-07-30

Added

[3.0.0] - 2025-07-29

Added

Changed

[2.3.0] - 2025-07-02

Added

[2.2.0] - 2025-06-06

Added

[2.1.0] - 2025-05-30

Added

[2.0.0] - 2025-05-16

Added

Changed

[1.2.0] - 2025-05-14

Added

[1.1.1] - 2025-05-08

Fixed

[1.1.0] - 2025-05-02

Unified API

Added

Was this helpful?

Changelog
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude