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
      • Add or Update Booking Package
      • Get Booking Document List
      • Get Booking BEO List
      • Get Booking BEO Version List
      • 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
    • Get Industry 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 Room Reservation List
  • Booking Room Reservation
  • Room Reservation Status
  • Reserved Room
  • Reserved Room Status
  • Reserved Room Day Rates
  • Reserved Room Additional Guests
  • Guest
  • Guest Contact Details
  1. Venue
  2. Booking Accommodation Data

Get Booking Room Reservation List

Get Booking Room Reservation List

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

Get a list of booking room reservations for venue.

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 room reservations belong

start

integer

The starting result of the page. Note this is zero based (i.e. sending start=0 will start from the first result.)

perPage

integer

The number of booking room reservations to fetch

{
    "meta": {
        "totalResults": 1,
        "start": 0,
        "perPage": 5,
        "count": 1
    },
    "results": [{
        "id": 3241,
        "venueId": 131,
        "bookingId": 4248,
        "reference": 164,
        "mainGuestId": 542,
        "mainGuest": {
            "id": 542,
            "guestContact": {
                "id": 431,
                "firstName": "Test1",
                "lastName": "Com1",
                "email": "test1.com1@somewhere.com",
                "phone": "071234567890",
                "createdDate": "2018-08-17 14:51:35 UTC",
                "modifiedDate": "2018-08-17 14:51:35 UTC"
            },
            "primaryPhone": "071234567890",
            "address": null,
            "createdDate": "2018-08-17 14:51:35 UTC",
            "modifiedDate": "2018-08-17 14:51:35 UTC"
        },
        "currentStatus": 2,
        "isFromGroup": true,
        "totalAmount": 745.00,
        "rooms": [
            {
                "id": 123,
                "guestId": 542,
                "guest": {
                    "id": 542,
                    "guestContact": {
                        "id": 431,
                        "firstName": "Test1",
                        "lastName": "Com1",
                        "email": "test1.com1@somewhere.com",
                        "phone": "071234567890",
                        "createdDate": "2018-08-17 14:51:35 UTC",
                        "modifiedDate": "2018-08-17 14:51:35 UTC"
                    },
                    "primaryPhone": "071234567890",
                    "address": null,
                    "createdDate": "2018-08-17 14:51:35 UTC",
                    "modifiedDate": "2018-08-17 14:51:35 UTC"
                },
                "barId": 57,
                "roomId": 14,
                "groupId": 7589,
                "currentStatus": 3,
                "numRooms": 1,
                "arrivalDate": "2018-09-01",
                "departureDate": "2018-09-04",
                "totalAmount": 545.00,
                "excludedTaxIds": [],
                "numAdultGuests": 1,
                "numChildGuests": 0,
                "createdDate": "2018-08-17 14:51:35 UTC",
                "modifiedDate": "2018-08-17 14:51:35 UTC",
                "isCancelled": false,
                "cancelledDate": null,
                "dayRates": [
                    {
                        "dayDate": "2018-09-01",
                        "barId": 57,
                        "cost": 180.00
                        "totalAmount": 180.00
                        "totalTaxAmount": 18.00
                    },
                    {
                        "dayDate": "2018-09-02",
                        "barId": 57,
                        "cost": 190.00
                        "totalAmount": 190.00
                        "totalTaxAmount": 19.00

                    },
                    {
                        "dayDate": "2018-09-03",
                        "barId": 57,
                        "cost": 175.00
                        "totalAmount": 175.00
                        "totalTaxAmount": 17.00
                    }
                ],
                "additionalGuests": []
            },
            {
                "id": 124,
                "guestId": 543,
                "guest": {
                    "id": 543,
                    "guestContact": {
                        "id": 432,
                        "firstName": "Test2",
                        "lastName": "Com2",
                        "email": "test2.com2@somewhere.com",
                        "phone": "",
                        "createdDate": "2018-08-17 14:52:21 UTC",
                        "modifiedDate": "2018-08-17 14:52:21 UTC"
                    },
                    "primaryPhone": "070987654321",
                    "address": {
                        "line1": "123 Some Street",
                        "line2": "",
                        "line3": "",
                        "line4": "",
                        "city": "Brisbane",
                        "postalCode": "4001",
                        "countryCode": "AU",
                        "stateCode": "QLD",
                        "stateName": ""
                    },
                    "createdDate": "2018-08-17 14:52:21 UTC",
                    "modifiedDate": "2018-08-17 14:52:21 UTC"
                },
                "barId": 57,
                "roomId": 14,
                "groupId": 7589,
                "currentStatus": 3,
                "numRooms": 1,
                "arrivalDate": "2018-09-02",
                "departureDate": "2018-09-03",
                "totalAmount": 200.00,
                "excludedTaxIds": [],
                "numAdultGuests": 1,
                "numChildGuests": 0,
                "createdDate": "2018-08-17 14:52:21 UTC",
                "modifiedDate": "2018-08-17 14:52:21 UTC",
                "isCancelled": false,
                "cancelledDate": null,
                "dayRates": [
                    {
                        "date": "2018-09-02",
                        "barId": 57,
                        "cost": 200.00
                        "totalAmount": 200.00
                        "totalTaxAmount": 20.00
                    }
                ],
                "additionalGuests": [
                    {
                        "guestId": 601,
                        "guest": {
                            "id": 601,
                            "guestContact": {
                                "id": 800,
                                "firstName": "Jane",
                                "lastName": "Doe",
                                "email": "Jane.Doe@test.com",
                                "phone": "123654789",
                                "createdDate": "2018-08-17 18:43:33 UTC",
                                "modifiedDate": "2018-08-17 18:43:33 UTC"
                            },
                            "primaryPhone": "123654789",
                            "address": null,
                            "createdDate": "2018-08-17 18:43:33 UTC",
                            "modifiedDate": "2018-08-17 18:43:33 UTC"
                        },
                        "arrivalDate": "2018-09-02",
                        "departureDate": "2018-09-03",
                        "guestType": 2
                    }
                ],
                "overrideBlockCapacity": true
            }
        ]
    }]
}

Booking Room Reservation

Property
Type
Description

id

integer

The unique id of the booking room reservation

venueId

integer

The unique id of the venue to which the booking belongs

bookingId

integer

The unique id of the booking to which the room reservation belongs

canBeEdited

boolean

Whether or not changes to the booking room reservation are allowed

reference

integer

A unique reference assigned to the room reservation

mainGuestId

integer

The unique id of the main guest of the reservation

mainGuest

Details of the main guest of the room reservation

currentStatus

integer

cancelledDate

datetime

The date & time the room reservation was cancelled

isFromGroup

boolean

totalAmount

number

The total amount of the room reservation. The amount either includes or excludes tax depending on how the venue is configured

createdDate

datetime

The date & time the room reservation was created

modifiedDate

datetime

The date & time the room reservation was last modified

rooms

The details of the rooms that have been reserved

Room Reservation Status

Status
Description

1

Not confirmed

2

Confirmed

3

Cancelled

4

Checked In

5

Checked Out

Reserved Room

Property
Type
Description

id

integer

The unique id of the reserved room

guestId

integer

The unique id of the venue guest

guest

Details of the guest assigned to the reserved room

barId

integer

The unique id of the rate plan assigned to the reserved room. If the reserved room applies to an accommodation group (see property isFromGroup above) then this will always be the rate plan assigned to the accommodation group

roomId

integer

The unique id of the room type that is reserved. If the reserved room applies to an accommodation group (see property isFromGroup above) then this will always be the room type assigned to the accommodation group

groupId

integer

currentStatus

integer

numRooms

integer

The number of rooms reserved. This value is always 1

arrivalDate

date

The arrival date of the reserved room

departureDate

date

The departure date of the reserved room

totalAmount

number

The total amount of the reserved room. The amount either includes or excludes tax depending on how the venue is configured

excludedTaxIds

array of integers

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

numAdultGuests

integer

The number of adults on the reserved room

numChildGuests

integer

The number of children on the reserved room

createdDate

datetime

The date & time the reserved room was created

modifiedDate

datetime

The date & time the reserved room was last modified

isCancelled

boolean

Whether or not the reserved room is cancelled

cancelledDate

datetime

The date & time the reserved room was cancelled

dayRates

The daily rates of the reserved room

additionalGuests

The additional guests of the reserved room

overrideBlockCapacity

boolean

Whether or not the number of reservations can exceed the block

occType

integer

Reserved Room Status

Status
Description

1

Not confirmed

2

Confirmed

3

Cancelled

4

Checked In

5

Checked Out

Reserved Room Day Rates

Property
Type
Description

dayDate

date

The date of the reserved room to which the rate applies

barId

integer

The unique id of the rate plan assigned to the dayDate of the reserved room. If the reserved room applies to an accommodation group (see property isFromGroup above) then this will always be the room type assigned to the accommodation group

cost

number

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

totalAmount

number

The rate amount(incl tax) for reserved room on dayRate. The amount is always tax inclusive regardless on how venue is configured

totalTaxAmount

number

The total tax amount included in totalAmount

Reserved Room Additional Guests

Property
Type
Description

guestId

integer

The identifier of guest being updated on the reserved room

guest

The additional guest details for the reserved room

arrivalDate

date

The arrival date of the additional guest

departureDate

date

The departure date of the additional guest

guestType

enum

Guest

Property
Type
Description

id

integer

The unique id of the venue guest

guestContact

The contact details of the guest

primaryPhone

string

The primary phone number of the guest

address

The address of the guest

isAnonymised

boolean

Whether or not the guest details have been anonymised

createdDate

datetime

The date & time the venue guest was created

modifiedDate

datetime

The date & time the venue guest was last modified

Guest Contact Details

Property
Type
Description

id

integer

firstName

string

The first name of the contact

lastName

string

The last name of the contact

email

string

The email address of the contact

phone

string

The mobile phone number of the contact

createdDate

datetime

The date & time the contact was created

modifiedDate

datetime

The date & time the contact was last modified

PreviousRemove Booking AccommodationNextAdd or Update Booking Room Reservation

Last updated 1 month ago

The result from this call will be a of booking room reservation records the user has access to. This call also accepts the and properties.

The current of the room reservation

Whether or not the room reservation applies to an

array of

The unique id of the from which the room is reserved (see property isFromGroup above)

The current of the reserved room

array of

array of

The occupancy type of the reserverd room See

The sharing type of additional guest. See

The unique id of the

collection
pagination
filter
accommodation group
accommodation group
Address
contact
Guest
status
Reserved Rooms
Guest
status
Day Rates
Additional Guests
Guest
Contact
Occupancy Type
Additional Guest Type