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

200

{
    "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": "[e-mail]",
                "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": "[e-mail]",
                        "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
                    },
                    {
                        "dayDate": "2018-09-02",
                        "barId": 57,
                        "cost": 190.00
                    },
                    {
                        "dayDate": "2018-09-03",
                        "barId": 57,
                        "cost": 175.00
                    }
                ],
                "additionalGuests": []
            },
            {
                "id": 124,
                "guestId": 543,
                "guest": {
                    "id": 543,
                    "guestContact": {
                        "id": 432,
                        "firstName": "Test2",
                        "lastName": "Com2",
                        "email": "[e-mail]",
                        "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
                    }
                ],
                "additionalGuests": [
                    {
                        "guestId": 601,
                        "guest": {
                            "id": 601,
                            "guestContact": {
                                "id": 800,
                                "firstName": "Jane",
                                "lastName": "Doe",
                                "email": "[e-mail]",
                                "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
            }
        ]
    }]
}

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

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	Guest	Details of the main guest of the room reservation
currentStatus	integer	The current status of the room reservation
cancelledDate	datetime	The date & time the room reservation was cancelled
isFromGroup	boolean	Whether or not the room reservation applies to an accommodation group
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	array of Reserved 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	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	The unique id of the accommodation group from which the room is reserved (see property isFromGroup above)
currentStatus	integer	The current status of the reserved room
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	array of Day Rates	The daily rates of the reserved room
additionalGuests	array of Additional Guests	The additional guests of the reserved room
overrideBlockCapacity	boolean	Whether or not the number of reservations can exceed the block
occType	integer	The occupancy type of the reserverd room See Occupancy Type

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

Reserved Room Additional Guests

Property	Type	Description
guestId	integer	The identifier of guest being updated on the reserved room
guest	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	The sharing type of additional guest. See Additional Guest Type

Guest

Property	Type	Description
id	integer	The unique id of the venue guest
guestContact	Contact	The contact details of the guest
primaryPhone	string	The primary phone number of the guest
address	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	The unique id of the contact
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