Skip to content
/
Retrieve a booking by ID

Bookings VenueAPI (4.10.0)

Bookings VenueAPI is a RESTful, OpenAPI-based interface that enables seamless, standardized booking operations across diverse venue management systems (RMS).

Designed for maximum interoperability, the API allows platforms to search, discover, and book venues regardless of the underlying technology stack.

Key capabilities include:

  • Retrieving venue data and availability in real-time
  • Creating bookings through a unified interface
  • Supporting both direct bookings and inquiry-based workflows
  • Enabling venues and distributors to discover each other via a dynamic, service-driven marketplace

The API supports RBAC-secured OAuth2 to ensure role-based access control and secure data transactions. Built for SaaS environments, this service offers scalable, multi-tenant integrations for distribution platforms, booking engines, and RMS providers.

Download OpenAPI description
BookingApi.json
BookingApi.yaml
Overview
URL
https://www.bookabletech.com
Bookable
hello@bookabletech.com
Languages
Servers
Staging
https://api-staging.bookabletech.com/
Production
https://api.bookabletech.com/

Venue

Information about venue

Operations

Retrieve a list of venues

Request

Returns a paginated list of venues available to the authenticated user or system. This endpoint supports page-based pagination to efficiently retrieve large sets of results.

Security
Staging or Production
Query
venueNamestring[ 2 .. 100 ] characters

Filter venues by name. Supports partial matching (case-insensitive). Example: "dishoom" will match "Dishoom Covent Garden".

Example: venueName=dishoom
venueGroupNamestring[ 2 .. 100 ] characters

Filter venues by group or chain name. Supports partial matching (case-insensitive). Example: "gordon ramsay" will match all Gordon Ramsay restaurants.

Example: venueGroupName=gordon ramsay
featuresArray of strings[ 1 .. 10 ] items

Filter venues by features. Supports multiple values separated by commas. Available features include: dog_friendly, wifi, parking, wheelchair_accessible, tv_sports, live_music, karaoke, pool_table, romantic, casual, family_friendly, quiet, lively, italian, asian, vegetarian, seafood, etc.

Example: features=dog_friendly,wifi,romantic
contentstring[ 3 .. 200 ] characters

Filter venues by description content. Supports partial matching (case-insensitive). Searches within the venue's content/description field.

Example: content=bombay cuisine
productNamestring[ 2 .. 100 ] characters

Filter venues by product/experience name. Supports partial matching (case-insensitive). Searches within product names and experience names.

Example: productName=dining room
bookingDaysArray of strings(DayOfWeek)[ 1 .. 7 ] items

Filter venues by available booking days. Supports multiple values separated by commas. Use day names (monday, tuesday, wednesday, thursday, friday, saturday, sunday).

Items Enum"sunday""monday""tuesday""wednesday""thursday""friday""saturday"
Example: bookingDays=monday,tuesday,friday
areastring[ 2 .. 100 ] characters

Filter venues by area/location. Supports partial matching (case-insensitive). Searches within the venue's area field.

Example: area=covent garden
citystring[ 2 .. 100 ] characters

Filter venues by city. Supports partial matching (case-insensitive).

Example: city=london
streetstring[ 3 .. 200 ] characters

Filter venues by street address. Supports partial matching (case-insensitive). Searches within the venue's street address field.

Example: street=upper st martin
venueTypesArray of strings[ 1 .. 10 ] items

Filter venues by type. Supports multiple values separated by commas. Available types include: restaurant, bar, cafe, hotel, pub, club, etc.

Example: venueTypes=restaurant,bar
datestring(date)

Filter venues by booking rules for a specific date. Format: ISO 8601 (YYYY-MM-DD). Returns venues that accept bookings on the specified date according to their booking rules. When both 'date' and 'bookingDays' filters are provided, the 'date' filter takes precedence and overrides the 'bookingDays' filter.

Example: date=2025-10-15
timestring or null(time)

Filter venues by booking rules at a specific time. Format: 24-hour (HH:MM). Returns venues that accept bookings at the specified time according to their booking rules. Must be used in conjunction with the date parameter.

Example: time=19:30
pageNumberinteger>= 1

The index of the page to return (default is 1).

Default 1
pageSizeinteger[ 1 .. 100 ]

The number of items to return per page (default is 20, max is 100).

Default 20
sortBystring

The field to sort results by. Defaults to 'Default' (composite ID ordering).

  • default: Sort by composite ID (venue_group_id, rms_id, venue_id)
  • name: Sort venues alphabetically by name
  • city: Sort venues by city name, then by venue name
  • area: Sort venues by area, then by venue name
  • venueGroup: Sort venues by venue group name (requires venueGroupName filter)
  • relevance: Sort by semantic similarity using vector embeddings (requires at least one embedding filter: venueName, content, or features with semantic search enabled)
Default "default"
Enum"default""name""city""area""venueGroup""relevance"
Example: sortBy=Name
sortDirectionstring

The direction to sort results. Defaults to 'ASC'.

  • ASC: Ascending order (A-Z, 0-9, most similar to least similar for relevance)
  • DESC: Descending order (Z-A, 9-0, least similar to most similar for relevance)
Default "ASC"
Enum"ASC""DESC"
Example: sortDirection=ASC
Headers
X-Partner-Referencestring

Required for Bookable Agents. Specifies the partner reference for whom the booking is being made. This header must contain a valid partner reference when making requests with the agent:write scope.

Example: bottomlessbrunch.com
X-Correlation-IDstring

An optional ID which you can use to track transactions across multiple systems. It can have any value, but we recommend avoiding . characters. Mirrored back in a response header.

Example: 11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA
curl -i -X GET \
  'https://api-staging.bookabletech.com/venues?venueName=dishoom&venueGroupName=gordon+ramsay&features=dog_friendly%2Cwifi%2Cromantic&content=bombay+cuisine&productName=dining+room&bookingDays=monday%2Ctuesday%2Cfriday&area=covent+garden&city=london&street=upper+st+martin&venueTypes=restaurant%2Cbar&date=2025-10-15&time=19%3A30&pageNumber=1&pageSize=20&sortBy=Name&sortDirection=ASC' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'X-Correlation-ID: 11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA' \
  -H 'X-Partner-Reference: bottomlessbrunch.com'

Responses

A list of venues was successfully retrieved.

Bodyapplication/json
metaobject
dataArray of objects(Venue)

A list of venue records for the current page.

Response
application/json
{
  "meta": {
    "totalItems": 0,
    "totalPages": 0,
    "currentPage": 0,
    "limit": 0
  },
  "data": [
    { … }
  ]
}

Get the venue

Request

Retrieve a list of venues.

Security
Staging or Production
Path
venueIdstringrequired

The id of venue

Example: 29|X9|275cc44dd2e2496fba44857c9257443a
Headers
X-Partner-Referencestring

Required for Bookable Agents. Specifies the partner reference for whom the booking is being made. This header must contain a valid partner reference when making requests with the agent:write scope.

Example: bottomlessbrunch.com
X-Correlation-IDstring

An optional ID which you can use to track transactions across multiple systems. It can have any value, but we recommend avoiding . characters. Mirrored back in a response header.

Example: 11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA
curl -i -X GET \
  'https://api-staging.bookabletech.com/venues/29|X9|275cc44dd2e2496fba44857c9257443a' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'X-Correlation-ID: 11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA' \
  -H 'X-Partner-Reference: bottomlessbrunch.com'

Responses

Schema for the response returned when retrieving a list of venues.

Bodyapplication/json
idstringrequired

Unique identifier for the venue.

namestringrequired

The name of the venue.

contentstring

Description or additional content about the venue.

phone_numberstring

The contact phone number of the venue.

websitestring(uri)

The official website of the venue.

reservableboolean

Indicates if the venue can be reserved.

locationobject(Location)
typesArray of strings

A list of types that categorize the venue.

photosArray of strings

A collection of photo URLs representing the venue.

updated_atstring(date-time)

Timestamp when the venue was last updated.

productsArray of objects(Product)

List of products available at the venue.

packagesArray of objects(Package)

List of packages available at the venue.

menusArray of objects(Menu)

List of menus available at the venue.

opening_timesobject

Opening times for the venue, including weekly schedule and specific date overrides.

Example: {"monday":{"status":true,"open":"10:00","close":"23:00","notes":"","private_hire":false},"tuesday":{"status":true,"open":"10:00","close":"23:00","notes":"","private_hire":false},"2025-12-25":{"status":false,"open":"","close":"","notes":"Closed for Christmas"}}
is_activebooleanDeprecated

Indicates if the venue is currently active.

Default true
created_atstring(date-time)Deprecated

Timestamp when the venue was created.

Response
application/json
{
  "id": "string",
  "name": "string",
  "content": "string",
  "phone_number": "string",
  "website": "http://example.com",
  "reservable": true,
  "location": {
    "area": "string",
    "city": "string",
    "lat": 0.1,
    "lng": 0.1,
    "street": "string",
    "postCode": "string",
    "gPlace": "string"
  },
  "types": [
    "string"
  ],
  "photos": [
    "string"
  ],
  "is_active": true,
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "products": [
    { … }
  ],
  "packages": [
    { … }
  ],
  "menus": [
    { … }
  ],
  "opening_times": {
    "monday": { … },
    "tuesday": { … },
    "2025-12-25": { … }
  }
}

Check venue availability

Request

Security
Staging or Production
Path
compositeIdstringrequired

The unique identifier of the venue or product.

Query
AvailabilityRequestobject(AvailabilityRequest)
Headers
X-Partner-Referencestring

Required for Bookable Agents. Specifies the partner reference for whom the booking is being made. This header must contain a valid partner reference when making requests with the agent:write scope.

Example: bottomlessbrunch.com
X-Correlation-IDstring

An optional ID which you can use to track transactions across multiple systems. It can have any value, but we recommend avoiding . characters. Mirrored back in a response header.

Example: 11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA
curl -i -X GET \
  'https://api-staging.bookabletech.com/venues/{compositeId}/availability?partySize=1&date=2019-08-24&startTime=14%3A15%3A22Z&endTime=23%3A59&duration=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'X-Correlation-ID: 11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA' \
  -H 'X-Partner-Reference: bottomlessbrunch.com'

Responses

Success response

Bodyapplication/json
namestring

The name of the available booking option.

depositnumber(float)

The deposit amount required for the booking.

policystring

General policy details regarding the booking.

cancellationPolicystring

Terms and conditions for canceling the booking.

timesArray of objects
noAvailabilityActionstring

Strategy provided by the RMS (Restaurant Management System) when no availability is found. Defines fallback actions or alternative options to present to customers.

autoConfirmRuleobject(AutoConfirmRule)

Defines the criteria for automatically confirming bookings without manual intervention.

Response
application/json
{
  "name": "string",
  "deposit": 0.1,
  "policy": "string",
  "cancellationPolicy": "string",
  "times": [
    { … }
  ],
  "noAvailabilityAction": "string",
  "autoConfirmRule": {
    "date": "2019-08-24",
    "dateType": "string",
    "minPeople": 0,
    "maxPeople": 0,
    "timeFrom": "14:15:22Z",
    "timeTo": "14:15:22Z",
    "weekdays": { … }
  }
}

Create a new booking

Request

Security
Staging or Production
Path
compositeIdstringrequired

The unique identifier of the venue/product.

Headers
X-Partner-Referencestring

Required for Bookable Agents. Specifies the partner reference for whom the booking is being made. This header must contain a valid partner reference when making requests with the agent:write scope.

Example: bottomlessbrunch.com
X-Correlation-IDstring

An optional ID which you can use to track transactions across multiple systems. It can have any value, but we recommend avoiding . characters. Mirrored back in a response header.

Example: 11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA
X-Booking-Sourcestring

Identifies the source or channel through which the booking was created. Valid values include:

  • "email" - Booking created via email integration
  • "phone" - Booking created via phone integration
  • "api" - Booking created via API (default if not provided)
  • "webhook" - Booking created via webhook integration
  • "js-tag" - Booking created via JavaScript tag integration
  • "chatbot" - Booking created via chatbot integration
  • "puller" - Booking created via puller synchronization
  • "portal" - Booking created via portal integration

If not provided, defaults to "api" in the application logic.

Enum"email""phone""api""webhook""js-tag""chatbot""puller""portal"
Example: api
Bodyapplication/jsonrequired
firstNamestringrequired

The first name for the booking.

Example: "John"
lastNamestringrequired

The last name for the booking.

Example: "Doe"
partySizeinteger>= 1required

The number of people the booking is for.

Example: 4
datestring or null(date)required

The date of the booking, in the format YYYY-MM-DD.

Example: "2025-02-15"
timestring or null(time)required

The time of the booking, in the format HH:mm.

Example: "18:30"
typestring(AvailabilityType)required

Specifies how an operators time slot can be handled. A value of book indicates the slot is available for instant confirmation, while request means the slot requires manual approval through an enquiry-based process.

Enum"book""request"
Example: "request"
durationinteger or null

The duration of the booking in minutes.

Example: 90
emailstring(email)^\S+@\S+\.\S+$required

The guest’s email address.

Example: "john.doe@example.com"
phonestringrequired

The guest’s phone number.

Example: 1234567890
notesstring or null

Any additional booking notes or special requests.

Example: "Please prepare a birthday cake."
adminNotesArray of strings or null

Internal notes or comments specific to the distributor.

commentsArray of strings or null

Additional comments or notes provided by the distributor.

labelsArray of strings or null

A list of labels or tags associated with the booking.

preordersArray of objects or null(PreorderRequest)

a list of preorder packages associated with the booking.

preorderMenusArray of objects or null(PreorderMenuRequest)

a list of preorder menus associated with the booking.

partnerBookingIdstring or null

Optional field that stores a reference code or unique identifier provided by an external system, used to link or synchronize records across platforms.

curl -i -X POST \
  'https://api-staging.bookabletech.com/venues/{compositeId}/booking' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-Booking-Source: api' \
  -H 'X-Correlation-ID: 11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA' \
  -H 'X-Partner-Reference: bottomlessbrunch.com' \
  -d '{
    "firstName": "John",
    "lastName": "Doe",
    "partySize": 4,
    "date": "2025-02-15",
    "time": "18:30",
    "type": "request",
    "duration": 90,
    "email": "john.doe@example.com",
    "phone": 1234567890,
    "notes": "Please prepare a birthday cake.",
    "adminNotes": [
      "string"
    ],
    "comments": [
      "string"
    ],
    "labels": [
      "string"
    ],
    "preorders": [
      {
        "productId": "62692e90d2cf1f163744efc4",
        "packageId": "62692e90d2cf1f163744efc4",
        "quantity": 2
      }
    ],
    "preorderMenus": [
      {
        "menuId": "62692e90d2cf1f163744efc4"
      }
    ],
    "partnerBookingId": "string"
  }'

Responses

Success created

Bodyapplication/json
idstring
Example: "29|X9|275cc44dd2e2496fba44857c9257443a|B"
Response
application/json
{
  "id": "29|X9|275cc44dd2e2496fba44857c9257443a|B"
}

Retrieve a list of bookings

Request

Returns a paginated list of all bookings.

Security
Staging or Production
Query
cursorstring

A pagination cursor indicating the starting point for the next set of results. If not provided, the first page of results will be returned.

Headers
X-Partner-Referencestring

Required for Bookable Agents. Specifies the partner reference for whom the booking is being made. This header must contain a valid partner reference when making requests with the agent:write scope.

Example: bottomlessbrunch.com
X-Correlation-IDstring

An optional ID which you can use to track transactions across multiple systems. It can have any value, but we recommend avoiding . characters. Mirrored back in a response header.

Example: 11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA
curl -i -X GET \
  'https://api-staging.bookabletech.com/venues/bookings?cursor=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'X-Correlation-ID: 11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA' \
  -H 'X-Partner-Reference: bottomlessbrunch.com'

Responses

A list of bookings

Bodyapplication/json
dataArray of objects(Bookings)

The list of bookings

cursorstring

A cursor that can be used to retrieve the next page of results. If null or absent, there are no further pages.

Response
application/json
{
  "data": [
    { … }
  ],
  "cursor": "string"
}

Retrieve a booking by ID

Request

Returns a specific booking by its unique ID.

Security
Staging or Production
Path
bookingIdstringrequired

Unique identifier of the booking

Headers
X-Partner-Referencestring

Required for Bookable Agents. Specifies the partner reference for whom the booking is being made. This header must contain a valid partner reference when making requests with the agent:write scope.

Example: bottomlessbrunch.com
X-Correlation-IDstring

An optional ID which you can use to track transactions across multiple systems. It can have any value, but we recommend avoiding . characters. Mirrored back in a response header.

Example: 11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA
curl -i -X GET \
  'https://api-staging.bookabletech.com/venues/bookings/{bookingId}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'X-Correlation-ID: 11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA' \
  -H 'X-Partner-Reference: bottomlessbrunch.com'

Responses

Reservation details

Bodyapplication/json
idstring(The Booking ID)

A globally unique identifier for the booking.

compositeIdstring(The Composite ID)

A globally unique identifier for the venue/product.

datestring(date)(Reservation Date)

The date of the booking.

timestring(time)(Reservation Time)

The time of the booking.

partySizeinteger(int32)(Party Size)

Number of guests for the booking.

statusstring(Status)

Indicates the current status of the booking:

  • Pending: The booking request has been received but not yet processed.
  • InProgress: The enquiry has been received and assigned but is not yet confirmed.
  • Confirmed: The booking has been confirmed.
  • Cancelled: The booking was cancelled or rejected.
  • Deleted: The booking has been deleted from the system.
  • Lost: The booking was not completed before its scheduled date.
Enum"Pending""InProgress""Confirmed""Cancelled""Deleted""Lost"
firstNamestring(First Name)

Guest's first name.

lastNamestring(Last Name)

Guest's last name.

emailstring(email)(Email)

Email address of the guest.

phonestring(Phone)

Phone number of the guest.

companystring(Company)

Company name if the booking is business-related.

locationobject(Location)
durationinteger(int32)(Duration)

Duration of the booking in minutes.

productTypestring(Product Type)

Type of product or service reserved.

notesstring(Notes)

Additional notes for the booking.

createdDatestring(date-time)(Created Date)

Timestamp when the booking was created.

lastUpdatestring(date-time)(Last Updated)

Timestamp of the last booking update.

preordersArray of objects

List of preordered packages for the booking.

preorderMenusArray of objects

List of preordered menus for the booking.

partnerBookingIdstring(Partner Booking Reference)

A custom booking identifier provided by the distributor (partner). This ID is submitted when creating a booking via API or Portal and serves as the partner’s own reference code for cross-system tracking.

operatorBookingIdstring(Operator Booking ID)

The booking identifier generated by the operator’s RMS platform (e.g., SevenRooms, Collins, Zonal). This ID uniquely identifies the reservation within the operator’s system and is displayed in the portal instead of the composite ID.

referencestring(Reference (deprecated))Deprecated

Legacy reference code for the booking. This field is deprecated and will be removed in future versions. Please use operatorBookingId instead.

Response
application/json
{
  "id": "string",
  "compositeId": "string",
  "date": "2019-08-24",
  "time": "14:15:22Z",
  "partySize": 0,
  "status": "Pending",
  "reference": "string",
  "firstName": "string",
  "lastName": "string",
  "email": "user@example.com",
  "phone": "string",
  "company": "string",
  "location": {
    "area": "string",
    "city": "string",
    "lat": 0.1,
    "lng": 0.1,
    "street": "string",
    "postCode": "string",
    "gPlace": "string"
  },
  "duration": 0,
  "productType": "string",
  "notes": "string",
  "createdDate": "2019-08-24T14:15:22Z",
  "lastUpdate": "2019-08-24T14:15:22Z",
  "preorders": [
    { … }
  ],
  "preorderMenus": [
    { … }
  ],
  "partnerBookingId": "string",
  "operatorBookingId": "string"
}

Update an existing booking by ID

Request

Security
Staging or Production
Path
bookingIdstringrequired

The unique identifier of the booking.

Headers
X-Partner-Referencestring

Required for Bookable Agents. Specifies the partner reference for whom the booking is being made. This header must contain a valid partner reference when making requests with the agent:write scope.

Example: bottomlessbrunch.com
X-Correlation-IDstring

An optional ID which you can use to track transactions across multiple systems. It can have any value, but we recommend avoiding . characters. Mirrored back in a response header.

Example: 11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA
Bodyapplication/jsonrequired
compositeIdstringrequired

The unique identifier of the venue/product.

Example: "29|X9|275cc44dd2e2496fba44857c9257443a|e4d909c290d0fb1ca068ffaddf22cbd0"
firstNamestringrequired

The first name for the booking.

Example: "John"
lastNamestringrequired

The last name for the booking.

Example: "Doe"
partySizeinteger>= 1required

The number of people the booking is for.

Example: 4
datestring or null(date)required

The date of the booking, in the format YYYY-MM-DD.

Example: "2025-02-15"
timestring or null(time)required

The time of the booking, in the format HH:mm.

Example: "18:30"
durationinteger or null

The duration of the booking in minutes.

Example: 120
emailstring(email)^\S+@\S+\.\S+$required

The guest’s email address.

Example: "john.doe@example.com"
phonestringrequired

The guest’s phone number.

Example: 1234567890
notesstring or null

Any additional booking notes or special requests.

Example: "Please prepare a birthday cake."
curl -i -X PUT \
  'https://api-staging.bookabletech.com/venues/bookings/{bookingId}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-Correlation-ID: 11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA' \
  -H 'X-Partner-Reference: bottomlessbrunch.com' \
  -d '{
    "compositeId": "29|X9|275cc44dd2e2496fba44857c9257443a|e4d909c290d0fb1ca068ffaddf22cbd0",
    "firstName": "John",
    "lastName": "Doe",
    "partySize": 4,
    "date": "2025-02-15",
    "time": "18:30",
    "duration": 120,
    "email": "john.doe@example.com",
    "phone": 1234567890,
    "notes": "Please prepare a birthday cake."
  }'

Responses

Reservation details

Bodyapplication/json
idstring(The Booking ID)

A globally unique identifier for the booking.

compositeIdstring(The Composite ID)

A globally unique identifier for the venue/product.

datestring(date)(Reservation Date)

The date of the booking.

timestring(time)(Reservation Time)

The time of the booking.

partySizeinteger(int32)(Party Size)

Number of guests for the booking.

statusstring(Status)

Indicates the current status of the booking:

  • Pending: The booking request has been received but not yet processed.
  • InProgress: The enquiry has been received and assigned but is not yet confirmed.
  • Confirmed: The booking has been confirmed.
  • Cancelled: The booking was cancelled or rejected.
  • Deleted: The booking has been deleted from the system.
  • Lost: The booking was not completed before its scheduled date.
Enum"Pending""InProgress""Confirmed""Cancelled""Deleted""Lost"
firstNamestring(First Name)

Guest's first name.

lastNamestring(Last Name)

Guest's last name.

emailstring(email)(Email)

Email address of the guest.

phonestring(Phone)

Phone number of the guest.

companystring(Company)

Company name if the booking is business-related.

locationobject(Location)
durationinteger(int32)(Duration)

Duration of the booking in minutes.

productTypestring(Product Type)

Type of product or service reserved.

notesstring(Notes)

Additional notes for the booking.

createdDatestring(date-time)(Created Date)

Timestamp when the booking was created.

lastUpdatestring(date-time)(Last Updated)

Timestamp of the last booking update.

preordersArray of objects

List of preordered packages for the booking.

preorderMenusArray of objects

List of preordered menus for the booking.

partnerBookingIdstring(Partner Booking Reference)

A custom booking identifier provided by the distributor (partner). This ID is submitted when creating a booking via API or Portal and serves as the partner’s own reference code for cross-system tracking.

operatorBookingIdstring(Operator Booking ID)

The booking identifier generated by the operator’s RMS platform (e.g., SevenRooms, Collins, Zonal). This ID uniquely identifies the reservation within the operator’s system and is displayed in the portal instead of the composite ID.

referencestring(Reference (deprecated))Deprecated

Legacy reference code for the booking. This field is deprecated and will be removed in future versions. Please use operatorBookingId instead.

Response
application/json
{
  "id": "string",
  "compositeId": "string",
  "date": "2019-08-24",
  "time": "14:15:22Z",
  "partySize": 0,
  "status": "Pending",
  "reference": "string",
  "firstName": "string",
  "lastName": "string",
  "email": "user@example.com",
  "phone": "string",
  "company": "string",
  "location": {
    "area": "string",
    "city": "string",
    "lat": 0.1,
    "lng": 0.1,
    "street": "string",
    "postCode": "string",
    "gPlace": "string"
  },
  "duration": 0,
  "productType": "string",
  "notes": "string",
  "createdDate": "2019-08-24T14:15:22Z",
  "lastUpdate": "2019-08-24T14:15:22Z",
  "preorders": [
    { … }
  ],
  "preorderMenus": [
    { … }
  ],
  "partnerBookingId": "string",
  "operatorBookingId": "string"
}

Cancel a booking by ID

Request

Security
Staging or Production
Path
bookingIdstringrequired

Unique identifier of the booking

Headers
X-Partner-Referencestring

Required for Bookable Agents. Specifies the partner reference for whom the booking is being made. This header must contain a valid partner reference when making requests with the agent:write scope.

Example: bottomlessbrunch.com
X-Correlation-IDstring

An optional ID which you can use to track transactions across multiple systems. It can have any value, but we recommend avoiding . characters. Mirrored back in a response header.

Example: 11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA
curl -i -X DELETE \
  'https://api-staging.bookabletech.com/venues/bookings/{bookingId}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'X-Correlation-ID: 11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA' \
  -H 'X-Partner-Reference: bottomlessbrunch.com'

Responses

Booking cancelled successfully

Response
No content

Booking

Information about the booking

Operations