Get Booking
Note: Section sessions, packages, additionalItems, beveragePackages, menus, resources, products and serviceFees are not published yet.
Get Booking
POST
[PlatformAddress]/api/1.0/venue?action=getBooking
Get the details of a specific booking to which the user has access.
Path Parameters
id
integer
The id of the booking
The result from this call will be the details of a specific booking to which the user has access. The unique booking identifier is required, for example {“id”:123}
Example Request
Booking
id
integer
The unique identifier of the booking
venueId
integer
The venue identifier of the booking
code
string
A reference assigned to the booking by the venue (only unique within a single venue)
name
string
The name of the booking
eventType
string
The event type of the booking
eventTypeId
integer
The event type id of the booking
companyId
integer
The unique id of the company assigned to the booking
contactId
integer
The unique id of the contact assigned to the booking
isConfidential
boolean
Whether or not the booking is confidential
totalAmount
double
The total amount of the booking, including tax
totalTaxAmount
double
The total tax of the booking
amountOutstanding
double
The amount outstanding of the booking, including tax
lastModifiedDate
The last modified date & time the booking or its children like Accommodation, Package, Session, Additional Items, etc.
isAccommIncluded
boolean
Whether or not the booking includes accommodation
focRoomsDenominator
int
The number of accommodation rooms in which one room is complimentary. For example if the value is 5, then 1 in 5 accommodation rooms will be complimentary.
maxNumFocRoomsPerDay
int
The maximum number of accommodation rooms per day that can be complimentary
hasPackages
boolean
Whether or not the booking has packages
canBeMoved
boolean
Whether or not the event/accommodation dates of the booking are flexible
bookedById
integer
The unique id of the event coordinator user assigned to the booking
beoNumbers
array
The id/numbers for the BEO documents assigned to the booking
isBeoFinalised
boolean
Whether or not the BEO of the booking has been finalised
otaFolioRef
string
The recorded Folio ID of a booking.
accommCutOffDate
After this date no more reservations may be made against the Block for the entire date range.
accommCancellationDate
The last date a customer can cancel their Group Accommodation without financial penalty.
accommChargingMethod
enum (Charging Method)
A record of the Charging Method for Documents, Note that values will still need to be altered in the Block.
accommGuaranteeRequired
boolean
Indicates whether the customer is required to guarantee their reservation with a credit card.
accommExternalBlockId
string
The Block ID from an external PMS.
leadBccEmail
string
The email address that can be used to record emails against this lead
totalAttendees
integer
The total number of attendees for the booking
hasCommissions
boolean
The booking pay comissions to an agent
hasCommissionPaid
boolean
The commission has been paid for the booking
commissionByCostCentres
Array of Commission By Cost Centres
The commission amount by Cost Centres in the Booking
opportunityId
integer
The id of the Opportunity for the Booking
hasCateringWebsite
boolean
Whether or not the catering website is enabled for the booking
cateringWebsiteLogoId
string
The catering website logo for the booking
cateringWebsiteBannerId
string
The catering website banner for the booking
cateringWebsiteEventDesc
string
The catering website event description for the booking
cateringWebsiteEndNumDays
integer
The catering website end num days from event start for the booking
File
id
integer
The file identifier
accountId
integer
The account id of a file
originalFileName
string
The original file name
size
integer
Size of the file
tags
array
Tags related to the file
contentType
string
Content type of the file
url
string
Url of the file
Status
One of the following values:
1
Prospective
2
Tentative
3
Confirmed
4
Cancelled
5
Ordering
8
Not Accepted
9
Prospective Hold
Daily Revenue
venueId
integer
The unique identifier of the venue to which the cost center belongs
costcenterId
integer
The unique identifier of the cost center to which the revenue applies
totalAmount
double
The total revenue amount, including tax
totalDiscountAmount
number
The amount of total discount
totalTaxAmount
double
The total tax amount that is included in the total revenue amount
Company
id
integer
The unique identifier of the company
businessName
integer
The business name of the company
Contact
id
integer
The unique identifier of the contact
firstName
string
The first name of the contact
lastName
string
The last name of the contact
string
The email address of the contact
phone
string
The phone number of the contact
Package
id
integer
The unique identifier for the booking package
numberAttendees
integer
The number of attendees for the booking package
price
double
The price of the booking package
totalAmount
double
The total amount of the booking package including tax amount
totalDiscount
double
The total amount of the discount
totalSurcharge
double
The total amount of the surcharge
totalTaxAmount
double
The tax amount of the booking package
costcenters
Array of Package Cost Centre
The list of costcenter and its individual value of the booking package
smallDescription
string
The small description of the booking package
packageId
string
The id of the venue package
packageName
string
The name of the venue package
Package Price Method
1
Per Person
2
Flat Rate
Package Cost Center
costcenterId
integer
The unique identifier of the cost center
value
double
The amount of the cost center
discount
double
The amount of the discount on value
surcharge
double
The amount of the surcharge on value
excludedTaxIds
array
The excluded tax identifiers
totalAmount
double
The amount of the cost center
totalSurcharge
double
The amount of the total surcharge
totalTaxAmount
double
The total tax amount of the cost center
Session
id
integer
The unique identifier of the session
name
string
The name of the session
spaceVenueId
integer
The id of the venue to which the space (spaceId) belongs (it can be different to the booking's venueId)
spaceId
integer
The space identifier booked by the session
spaceLayout
integer
The space layout identifier of the session
customLayoutName
string
The space layout name when space layout is custom
cost
double
The cost of the session
discount
double
The amount of the discount on cost
totalAmount
double
The total amount of session including tax amount
totalDiscount
double
The total amount of the discount
totalSurcharge
double
The total amount of the surcharge
totalTaxAmount
double
The tax amount of the session
excludedTaxIds
array
The excluded tax identifiers of the session
costcenterId
integer
The cost center identifier to which the session's revenue applies
includeInPackage
boolean
Whether or not the booking session is included in booking package
bookingPackageId
integer
The booking package identifier if the booking session is included in package
beoNumbers
array
The id/numbers of the BEO documents assigned to the booking session
totalAttendees
integer
The minimum number of attendees for the Booking session
Menu
id
integer
The unique identifier of the menu
name
string
The name of the menu
menuVenueId
integer
The venue identifier to which the menu package belongs. This can be different than booking's venue id
menuId
integer
The reference menu identifier in venue menus
sessionId
integer
The session identifier to which this menu belongs
cost
double
The cost of the menu
discount
double
The amount of the discount on cost
surcharge
double
The amount of the surcharge on cost
excludedTaxIds
array
The excluded tax identifiers
includeInPackage
boolean
Whether or not the menu is included in booking package
bookingPackageId
integer
The booking package identifier if menu is included in package
costcenterId
integer
The cost center identifier to which the revenue applies
totalAmount
double
The total amount of the menu including tax
totalDiscount
double
The total amount of the discount
totalSurcharge
double
The total amount of the surcharge
totalTaxAmount
double
The tax amount of the menu
totalAttendees
integer
The minimum number of attendees for the menu
Beverage Package
id
integer
The unique identifier of the beverage package
name
string
The name of the beverage package
sessionId
integer
The session identifier to which this beverage package belongs
beverageVenueId
integer
The venue identifier to which the beverage package belongs. This can be different than booking's venue id
beverageId
integer
The reference beverage package identifier in venue beverage packages
cost
double
The cost of the beverage package
discount
double
The amount of the discount on cost
surcharge
double
The amount of the surcharge on cost
excludedTaxIds
array
The excluded tax identifiers
includeInPackage
boolean
Whether or not the beverage package is included in booking package
bookingPackageId
integer
The booking package identifier if beverage package is included in package
costcenterId
integer
The cost center identifier to which the revenue applies
totalAmount
double
The total amount of the beverage package including tax
totalDiscount
double
The total amount of the discount
totalSurcharge
double
The total amount of the surcharge
totalTaxAmount
double
The tax amount of the beverage package
totalAttendees
integer
The minimum number of attendees for the beverage package
smallDescription
double
The small description of the beverage package
marketplaceName
double
The marketplace name of the beverage package
Resource
id
integer
The unique identifier of the resource
name
string
The name of the resource
sessionId
integer
The session identifier to which this resource belongs
cost
double
The cost of the resource
discount
double
The amount of the discount on cost
surcharge
double
The amount of the surcharge on cost
excludedTaxIds
array
The excluded tax identifiers
quantity
integer
The quantity of the resource
includeInPackage
boolean
Whether or not the resource is included in booking package
bookingPackageId
integer
The booking package identifier if resource is included in package
costcenterId
integer
The cost center identifier to which the revenue applies
totalAmount
double
The total amount of the resource including tax
totalDiscount
double
The total amount of the discount
totalSurcharge
double
The total amount of the surcharge
totalTaxAmount
double
The tax amount of the resource
Product
id
integer
The unique identifier of the product
name
string
The name of the product
sessionId
integer
The session identifier to which this product belongs
cost
double
The cost of the product
discount
double
The amount of the discount on cost
surcharge
double
The amount of the surcharge on cost
excludedTaxIds
array
The excluded tax identifiers
quantity
integer
The quantity of the product
includeInPackage
boolean
Whether or not the product is included in booking package
bookingPackageId
integer
The booking package identifier if product is included in package
costcenterId
integer
The cost center identifier to which the revenue applies
totalAmount
double
The total amount of the product including tax
totalDiscount
double
The total amount of the discount
totalSurcharge
double
The total amount of the surcharge
totalTaxAmount
double
The tax amount of the product
Additional Item
id
integer
The list of additional items of the booking
description
string
The description of the item
quantity
double
The quantity of the item
totalCost
double
The sale price of the item
totalCostDiscount
double
The amount of the discount on totalCost
totalCostSurcharge
double
The amount of the surcharge on totalCost
totalCostExcludedTaxIds
array
The sale price excluded tax identifiers
actualCost
double
The cost of the item
actualCostExcludedTaxIds
array
The cost excluded tax identifiers
costcenterId
integer
The cost center identifier to which the revenue applies
totalAmount
double
The total amount of the item including tax amount
totalDiscount
double
The total amount of the discount
totalSurcharge
double
The total amount of the surcharge
totalTaxAmount
double
The tax amount of the item
dayTaxDetails
Array of Day Tax Detail
The individual tax for each date. Empty when start date time is empty.
Service Fee
id
integer
The unique identifier of the applied service fee
refId
integer
The first identifier for identifying reference item in the booking
ref2Id
integer
The second identifier for identifying the reference item in the booking
ref3Id
integer
The third identifier for identifying the reference item in the booking
refCostcenterId
integer
The reference cost centre identifier to which the fee applies
amount
double
The amount of the service fee without tax
excludedTaxIds
array
The list of excluded tax ids
totalAmount
double
The total amount of the service including tax
totalTaxAmount
double
The tax amount of the service fee
Tax Detail
id
integer
The unique identifier of tax in venue
tax
double
The amount of tax applied
rateId
integer
The identifier of the rate that overrided the default tax rate. Zero (0) when the default tax rate is not overridden
rateAmount
double
The rate at which the tax was calculated
rateAmountType
integer
The rate type of the tax. 1 = A percentage, 2 = An amount
Day Tax Detail
Service Fee Reference Types
1
Booking Accommodation
Booking Accommodation Identifier
2
Booking Accommodation Option
Booking Accommodation Identifier
Booking Accommodation Option Id (roomOptionId)
Booking Accommodation Option Number (roomOptionNum)
3
Package
Booking Package Identifier
4
Session
Booking Session Identifier
5
Menu / Food
Booking Session Menu Identifier
6
Beverage Package
Booking Session Beverage Package Identifier
7
Product
Booking Session Product Identifier
8
Resource
Booking Session Resource Identifier
9
Additional Item
Booking Additional Item Identifier
11
Service
Booking Service Identifier
Commission By Cost Centres
costcenterId
integer
The cost center identifier to which the revenue applies
commission
integer
The commission amount by Cost Centres in the Booking
Booking Types
One of the following values:
1
Simple
2
Detailed
3
Accommodation Only
Food Beverage Payable By
One of the following values:
1
Master Account
2
Guests
Sales Person
id
integer
The unique identifier of the sales person
firstName
string
The first name of the sales person
lastName
string
The last name of the sales person
string
The email address of the sales person
phone
string
The phone number of the sales person
Booked By
id
integer
The unique identifier of the co-ordinator
firstName
string
The first name of the co-ordinator
lastName
string
The last name of the co-ordinator
string
The email address of the co-ordinator
phone
string
The phone number of the co-ordinator
Agent
id
integer
The unique identifier of the company
businessName
integer
The business name of the company
string
The email address of the company
phone
string
The phone number of the company
Menu Category
1
Breakfast
2
Lunch
3
Dinner
4
Coffee Break
5
Reception
6
Outside Catering
Costcenter
costcenterId
integer
required
The id of costcenter
costPerPerson
double
required
The cost per person value of a costcenter
costPerPersonExcludedTaxIds
optional
array of integers
The excluded cost tax ids applied to the price of this costcenter
External URL Field
An External URL field is an object with the following details.
ref
string
The unique reference key of the external URL
url
string
The url link (https) scheme eg. https://example.com
label
string
The label of the URL to display.
Last updated