iVvy Developer API
  • API Documentation
  • Getting Started
    • Obtaining Keys
    • Creating the request
      • Method/URI Header
      • Request Headers
        • Standard Headers
        • Custom Headers
      • Signing the request
      • Query Parameters
    • Test Ping
    • Interpreting the response
      • Collections
      • Pagination
      • Filtering
      • Exceptions
      • Response Headers
      • Dates
    • Batch
      • Run
      • Progress
      • Result
      • Restart
      • Repost
    • Use Cases
      • CRM Systems
      • Financial Accounting Systems
      • Point Of Sale
      • Property Management Systems
  • Contacts & Companies
    • Get Contact List
    • Get Contact
    • Get Contact Note List
    • Add or Update Contact
    • Get Contact Custom Field Definition
    • Get Company Custom Field Definition
    • Get Subscription Group List
    • Add Contacts To Subscription Group
    • Remove Contacts From Subscription Group
    • Get Company List
    • Get Company
    • Get Company Note List
    • Add or Update Company
    • Add or Update Lead
    • Add or Update Contact Note
    • Add or Update Company Note
  • Event
    • Add or Update Event
    • Get Event List
    • Get Event
    • Get Registration
    • Get Registration List
    • Get Attendee
    • Get Attendee List
    • Get Invited Contact List
    • Invite Contacts
    • Get Sponsorship List
    • Get Speaker List
    • Get Session List
    • Create Login Token
  • Venue
    • Venue Setup Data
      • Get Venue
      • Get Venue List
      • Get Venue Room List
      • Get Venue Room Option List
      • Get Venue Rate Plan List
      • Get Venue Rate Plan Rate List
      • Get Venue Rate Plan Room Rate List
      • Get Resource List
      • Get Resource Availability
      • Get Menu List
      • Get Beverage Package List
      • Get Function Space List
      • Get Space Blockout List
      • Get Function Space Category List
      • Get Function Space Availability
      • Get Function Space Hire Plan Rate List
      • Get Function Space Hire Plan Rate
      • Get Cost Center List
      • Get Session Type List
      • Get Revenue Template List
      • Get Tax List
      • Add or Update Function Space
      • Get Event Type List
      • Add or Update Function Space Category
      • Add or Update Guest Room
      • Get Booking Custom Field List
      • Get Space Hire Plans
      • Get Venue Package List
      • Get Venue Package
    • Booking Data
      • Convert Lead To Opportunity
      • Add or Update Opportunity
      • Get Booking
      • Get Booking List
      • Get Booking List For Account
      • Get Booking Notes
      • Get Booking Session List
      • Get Booking Session Menu List
      • Get Booking Changelog List
      • Get Booking Attendee (By Hash)
      • Get Booking Attendee List
      • Get Booking Release Schedule
      • Add or Update Booking
      • Change Booking Status
      • Add Items To Booking
      • Add Payment To Booking
      • Add Refund To Booking
      • Add or Update Booking Attendee
      • Add or Update Booking Note
      • Add or Update Booking Session
      • Add or Update Booking Session Beverage
      • Add or Update Booking Session Menu
      • Add or Update Booking Session Resource
      • Remove Booking Session
      • Remove Booking Session Beverage
      • Remove Booking Session Menu
      • Remove Booking Session Resource
      • Get Space Blockout List
      • Add or Update Blockout Space
      • Remove Blockout Space
      • Get Booking Tax List
      • Add or Update Opportunity Note
      • Upload Booking Document
    • Booking Accommodation Data
      • Get Booking Accommodation List
      • Add or Update Booking Accommodation
      • Remove Booking Accommodation
      • Get Booking Room Reservation List
      • Add or Update Booking Room Reservation
      • Update Room Reservation Guest Contact
      • Remove Booking Room Reservation
      • Confirm Booking Room Reservation
      • Cancel Booking Room Reservation
      • Change Status of Booking Room Reservation
      • Add or Update Room Counts
      • Add or Update Room Dynamic Rates
      • Remove Room Dynamic Rates
      • Add or Update Rate Plan Booking Rules
  • Partner
    • Get Venue List
    • Get Venue
  • Invoice
    • Get Invoice List
    • Get Invoice
    • Get Options
    • Add Payment
    • Get Credit Note List
    • Get Credit Note
  • Account
    • Add or Update Cost Center
    • Get Cost Center List
    • Get Email Log List
    • Add Error Report
    • Get Account User List
  • CRM
    • Get Lead List
    • Get Opportunity List
    • Get Opportunity Note List
    • Get Task List
    • Get Activity List
    • Get Lead Stage List
    • Get Lead Type List
    • Get Lead Quality List
    • Get Lead Source List
    • Get Lead Channel List
    • Get Lead Note List
    • Add or Update Activity Purpose
    • Add or Update Activity
    • Add or Update Task
    • Add or Update Lead Quality
    • Add or Update Lead Stage
    • Add or Update Lead Channel
    • Add or Update Lead Type
    • Add or Update Lead Source
    • Add or Update Lead Note
  • Notifications
    • Company Endpoint
    • Contact Endpoint
    • CRM Endpoint
    • Invoice Endpoint
    • Booking Endpoint
    • Event Endpoint
  • Development Reference
    • Calculating md5
    • HMAC-SHA1
    • JSON Encoding
    • Timestamp Format
    • Date Format
    • Time Format
    • Address Format
    • URLEncoding
    • Timezone List
  • Announcements
    • Room Reservation Contact Changes
    • Contact Customfield Changes
    • Booking Accommodation API Changes
Powered by GitBook
On this page
  • Get Booking Accommodation List
  • Booking Accommodation (Group)
  • Booking Accommodation Day Rates Actual
  • Booking Accommodation Day Rates Forecast
  • Booking Accommodation Day Rates Net
  • Booking Accommodation Day Rates
  • Booking Accommodation Day Rates Actual Multi Occupancy
  • Booking Accommodation Day Rates Forecast Multi Occupancy
  • Booking Accommodation Day Rates Net Multi Occupancy
  • Booking Accommodation Day Rates Multi Occupancy
  • Booking Accommodation Room Option
  1. Venue
  2. Booking Accommodation Data

Get Booking Accommodation List

Get Booking Accommodation List

POST [PlatformAddress]/api/1.0/venue?action=getBookingAccommodationList

Get a list of booking accommodation (i.e. groups) for a specific venue booking.

Request Body

Name
Type
Description

venueId

integer

The unique id of the venue to which the bookings belong

bookingId

integer

The unique id of the booking to which the accommodation belongs

{
    "meta": {
        "totalResults": 5,
        "start": 0,
        "perPage": 5,
        "count": 5
    },
    "results": [{
        "id": 1432,
        "venueId": 178,
        "bookingId": 4304,
        "roomVenueId": 178,
        "barId": null,
        "roomId": 76,
        "startDate": "2018-08-27",
        "endDate": "2018-08-31",
        "overrideCapacity": true,
        "costcenterId": 1376,
        "includeInPackage": false,
        "cutOffDate": "2018-08-15",
        "dayRatesActual": [
            {
                "bookingDate": "2018-08-27",
                "numRooms": 11,
                "cost": 180,
                "discount": 10,
                "numPayableByGuest": 11
            },
            {
                "bookingDate": "2018-08-28",
                "numRooms": 12,
                "cost": 190,
                "discount": 10,
                "numPayableByGuest": 12
            },
            {
                "bookingDate": "2018-08-29",
                "numRooms": 13,
                "cost": 175,
                "discount": 10,
                "numPayableByGuest": 13
            },
            {
                "bookingDate": "2018-08-30",
                "numRooms": 14,
                "cost": 210,
                "discount": 10,
                "numPayableByGuest": 14
            }
        ],
        "dayRates": [
            {
                "bookingDate": "2018-08-27",
                "numRooms": 11,
                "cost": 180,
                "discount": 10,
                "numPayableByGuest": 11,
                "numFreeRooms": 1
            },
            {
                "bookingDate": "2018-08-28",
                "numRooms": 12,
                "cost": 190,
                "discount": 10,
                "numPayableByGuest": 12,
                "numFreeRooms": 1
            },
            {
                "bookingDate": "2018-08-29",
                "numRooms": 13,
                "cost": 175,
                "discount": 10,
                "numPayableByGuest": 13,
                "numFreeRooms": 1
            },
            {
                "bookingDate": "2018-08-30",
                "numRooms": 14,
                "cost": 210,
                "discount": 10,
                "numPayableByGuest": 14,
                "numFreeRooms": 1
            }
        ],
        "dayRatesNet": [
            {
                "bookingDate": "2018-08-27",
                "numRooms": 11,
                "cost": 180,
                "discount": 10,
                "numPayableByGuest": 11
            },
            {
                "bookingDate": "2018-08-28",
                "numRooms": 12,
                "cost": 190,
                "discount": 10,
                "numPayableByGuest": 12
            },
            {
                "bookingDate": "2018-08-29",
                "numRooms": 13,
                "cost": 175,
                "discount": 10,
                "numPayableByGuest": 13
            },
            {
                "bookingDate": "2018-08-30",
                "numRooms": 14,
                "cost": 210,
                "discount": 10,
                "numPayableByGuest": 14
            }
        ],
        "dayRatesForecast": [
            {
                "bookingDate": "2018-08-27",
                "numRooms": 11,
                "cost": 180,
                "discount": 10,
                "numPayableByGuest": 11
            },
            {
                "bookingDate": "2018-08-28",
                "numRooms": 12,
                "cost": 190,
                "discount": 10,
                "numPayableByGuest": 12
            },
            {
                "bookingDate": "2018-08-29",
                "numRooms": 13,
                "cost": 175,
                "discount": 10,
                "numPayableByGuest": 13
            },
            {
                "bookingDate": "2018-08-30",
                "numRooms": 14,
                "cost": 210,
                "discount": 10,
                "numPayableByGuest": 14
            }
        ],
        "excludedTaxIds": [],
        "roomOptions": [
            {
                "bookingDate": "2018-08-27",
                "roomOptionId": 35,
                "numRooms": 11,
                "priceType": 1,
                "numOptions": 1,
                "numOptionsPerRoom": 1,
                "price": 65,
                "discount": 10,
                "excludedTaxIds": [],
                "totalAmount": 715,
                "totalDiscount": 10,
                "totalTaxAmount": 65.01,
                "costcenterId": 1377,
                "numPayableByGuest": 11
            },
            {
                "bookingDate": "2018-08-30",
                "roomOptionId": 36,
                "numRooms": 10,
                "priceType": 1,
                "numOptions": 1,
                "numOptionsPerRoom": 1,
                "price": 80,
                "discount": 10,
                "excludedTaxIds": [],
                "totalAmount": 800,
                "totalDiscount": 10,
                "totalTaxAmount": 72.7,
                "costcenterId": 1377,
                "numPayableByGuest": 10
            }
        ],
        "createdDate": "2018-08-22 06:43:24 UTC",
        "modifiedDate": "2018-08-22 06:43:24 UTC"
    }]
}

Booking Accommodation (Group)

Property
Type
Description

id

integer

The unique id of the booking accommodation

venueId

integer

The unique id of the venue to which the booking belongs

bookingId

integer

The unique id of the booking to which the accommodation group belongs

roomVenueId

integer

The unique id of the venue to which the rate plan (barId) and room type (roomId) belong (can be different to venueId)

barId

integer

The unique id of the rate plan assigned to the accommodation group

roomId

integer

The unique id of the room type assigned to the accommodation group

startDate

date

The arrival date of the accommodation group

endDate

date

The departure date of the accommodation group

overrideCapacity

boolean

Whether or not the accommodation group can exceed the general room availability

costcenterId

integer

The unique id of the cost center assigned to the accommodation group

includeInPackage

boolean

Whether or not the accommodation is included in booking package

cutOffDate

date

The date after which changes to the accommodation group are not allowed

dayRatesActual

The daily actual rates of the accommodation group

dayRatesForecast

The daily forecast rates of the accommodation group

dayRatesNet

The daily net rates of the accommodation group

dayRates

The daily rates of the accommodation group

dayRatesActualMultiOcc

The daily actual rates for different occupancies of the accommodation group (Only available when feature enabled in venue)

dayRatesForecastMultiOcc

The daily forecast rates for different occupancies of the accommodation group (Only available when feature enabled in venue)

dayRatesNetMultiOcc

The daily net rates for different occupancies of the accommodation group (Only available when feature enabled in venue)

dayRatesMultiOcc

The daily rates for different occupancies of the accommodation group (Only available when feature enabled in venue)

excludedTaxIds

array of integers

The unique ids of the taxes that are excluded from the daily rates

roomOptions

The additional room options of the accommodation group

createdDate

datetime

The date & time the accommodation group was created

modifiedDate

datetime

The date & time the acommodation group was last modified

Booking Accommodation Day Rates Actual

Property
Type
Description

bookingDate

date

The actual date of the accommodation group to which the rate applies

numRooms

integer

The actual number of rooms booked on bookingDate

cost

number

The rate actual amount for the room on bookingDate. The amount either includes or excludes tax depending on how the venue is configured

discount

number

The actual amount of discount

numPayableByGuest

integer

The actual number of rooms on bookingDate that are payable by guests (as opposed to the master account of the booking)

Booking Accommodation Day Rates Forecast

Property
Type
Description

bookingDate

date

The forecast date of the accommodation group to which the rate applies

numRooms

integer

The forecast number of rooms booked on bookingDate

cost

number

The rate forecast amount for the room on bookingDate. The amount either includes or excludes tax depending on how the venue is configured

discount

number

The forecast amount of discount

numPayableByGuest

integer

The forecast number of rooms on bookingDate that are payable by guests (as opposed to the master account of the booking)

Booking Accommodation Day Rates Net

Property
Type
Description

bookingDate

date

The date of the accommodation group to which the rate applies

numRooms

integer

The number of rooms booked on bookingDate

cost

number

The rate amount for the room on bookingDate. The amount either includes or excludes tax depending on how the venue is configured

discount

number

The amount of discount

numPayableByGuest

integer

The number of rooms on bookingDate that are payable by guests (as opposed to the master account of the booking)

Booking Accommodation Day Rates

Property
Type
Description

bookingDate

date

The date of the accommodation group to which the rate applies

numRooms

integer

The number of rooms booked on bookingDate

cost

number

The rate amount for the room on bookingDate. The amount either includes or excludes tax depending on how the venue is configured

discount

number

The amount of discount

numPayableByGuest

integer

The number of rooms on bookingDate that are payable by guests (as opposed to the master account of the booking)

numFreeRooms

integer

The number of complimentary (free) rooms on bookingDate. This number is included in numRooms

Booking Accommodation Day Rates Actual Multi Occupancy

Property
Type
Description

bookingDate

date

The actual date of the accommodation group to which the rate applies

numRooms

integer

The actual number of rooms booked on bookingDate

cost

number

The rate actual amount for the room on bookingDate. The amount either includes or excludes tax depending on how the venue is configured

discount

number

The actual amount of discount

numPayableByGuest

integer

The actual number of rooms on bookingDate that are payable by guests (as opposed to the master account of the booking)

occType

integer

Booking Accommodation Day Rates Forecast Multi Occupancy

Property
Type
Description

bookingDate

date

The forecast date of the accommodation group to which the rate applies

numRooms

integer

The forecast number of rooms booked on bookingDate

cost

number

The rate forecast amount for the room on bookingDate. The amount either includes or excludes tax depending on how the venue is configured

discount

number

The forecast amount of discount

numPayableByGuest

integer

The forecast number of rooms on bookingDate that are payable by guests (as opposed to the master account of the booking)

occType

integer

Booking Accommodation Day Rates Net Multi Occupancy

Property
Type
Description

bookingDate

date

The date of the accommodation group to which the rate applies

numRooms

integer

The number of rooms booked on bookingDate

cost

number

The rate amount for the room on bookingDate. The amount either includes or excludes tax depending on how the venue is configured

discount

number

The amount of discount

numPayableByGuest

integer

The number of rooms on bookingDate that are payable by guests (as opposed to the master account of the booking)

occType

integer

Booking Accommodation Day Rates Multi Occupancy

Property
Type
Description

bookingDate

date

The date of the accommodation group to which the rate applies

numRooms

integer

The number of rooms booked on bookingDate

cost

number

The rate amount for the room on bookingDate. The amount either includes or excludes tax depending on how the venue is configured

discount

number

The amount of discount

numPayableByGuest

integer

The number of rooms on bookingDate that are payable by guests (as opposed to the master account of the booking)

numFreeRooms

integer

The number of complimentary (free) rooms on bookingDate. This number is included in numRooms

occType

integer

Booking Accommodation Room Option

Property
Type
Description

bookingDate

date

The date of the accommodation group to which the additional option applies

roomOptionId

integer

The unique id of the room option added on bookingDate

numRooms

integer

The number of rooms on bookingDate to which the room option applies

priceType

integer

numOptions

integer

The number options added to each room / guest on bookingDate

numOptionsPerRoom

integer

The number options added to each room (numRooms) on bookingDate

price

number

The price of the additional option. The amount either includes or excludes tax depending on how the venue is configured

discount

number

The amount of discount on price

excludedTaxIds

array of integers

The unique ids of the taxes that are excluded from price

totalAmount

number

The total value of the additional option on this date, including all applicable taxes

totalDiscount

number

The amount of total discount of option on this date

totalTaxAmount

number

The total tax amount included in totalAmount

costcenterId

integer

The unique id of the cost center assigned to the additional option

numPayableByGuest

integer

The number of additional options on bookingDate that are payable by guests (as opposed to the master account of the booking)

PreviousBooking Accommodation DataNextAdd or Update Booking Accommodation

Last updated 8 months ago

The result from this call will be a of booking accomodation records the user has access to. This call returns all accommodation records for a specific venue booking - it does not accept or properties.

array of

array of

array of

array of

array of

array of

array of

array of

array of

The occupancy type of daily rate. See

The occupancy type of daily rate. See

The occupancy type of daily rate. See

The occupancy type of daily rate. See

The price type of the room option. See

collection
pagination
filter
Day Rates Actual
Day Rates Forecast
Day Rates Net
Day Rates
Day Rates Actual
Day Rates Forecast
Day Rates Net
Day Rates
Room Options
Occupancy Type
Occupancy Type
Occupancy Type
Occupancy Type
Room Option