Get Reservation Details
Overview
The getReservationDetails
operation will return detailed information for the reservations matching the requested criteria.
Request
Element | Type | Description |
siteIDList | Array | Mandatory A list of property IDs for which reservation details should be returned. This must be a subset of properties that are enabled for your API. At least 1 siteID is required |
transactionReferenceList | Array | The transaction reference array will contain an entry for each transaction as requested in the siteIDList section of the request |
Sample
{
"userAuth": {
"username": "username",
"password": "password"
},
"operation": "getReservationDetails",
"siteIDList": [
1853
],
"transactionReferenceList": [
"3948484",
"6YP6UCL"
]
}
Response
Element | Â | Â | Â | Â | Type | Description |
siteList | Â | Â | Â | Â | Array | The siteList array will contain an entry for each site with transaction results. |
 | siteID |  |  |  | String | The internal siteID of the property in the IBE. |
 | primaryName |  |  |  | String | Property name. |
 | transactions |  |  |  | Array | Array of transaction results. |
 |  | reference |  |  | String | The internal transaction reference of the reservation in the IBE. |
 |  | dtCreated |  |  | String | The datetime the transaction was created. |
 |  | dtLastChanged |  |  | String | The last datetime the transaction was modified. |
 |  | status |  |  |  | The status of the reservation. |
 |  | newsletterSignup |  |  | String | Indicates if the booker signed up to receive newsletters. |
 |  | currency |  |  | String | The currency used to pay for the reservation. |
 |  | total |  |  | String | Total cost of the transaction. |
 |  | subTotal |  |  | String | Transaction cost before taxes and fees. |
 |  | taxesAndFees |  |  | String | The cost of any taxes and/or fees applicable to the transaction. |
 |  | moneyTaken |  |  | String | The amount paid by the customer to secure the booking. |
 |  | rate |  |  | Object | Details of the rate booked. |
 |  |  | rateID |  | String | The internal rateID of the rate booked. |
 |  |  | code |  | String | The internal code of the rate booked. |
 |  |  | name |  | String | The name of the rate booked. |
 |  | booker |  |  | Object | Details of the booker. |
 |  |  | name |  | Object | Details of the name of the booker. |
 |  |  |  | title | String | Booker title. |
 |  |  |  | first | String | Booker first name. |
 |  |  |  | last | String | Booker last name. |
 |  |  |  | String | Booker email address. | |
 |  |  | selectedLanguage |  | String | The language the booker used during the transaction. |
 |  |  | address |  | Object | Details of the booker address. |
 |  |  |  | line1 | String | Line 1 of the booker address. |
 |  |  |  | line2 | String | Line 2 of the booker address. |
 |  |  |  | townCity | String | Town of the booker address. |
 |  |  |  | postCode | String | Post code of the booker address. |
 |  |  |  | countyState | String | County / State of the booker address. |
 |  |  |  | countryCode | String | Country code of the booker address. |
 |  |  | phones |  | Array | A list of phone numbers provided by the booker. |
 |  |  |  | index | String | The index of the phone number in the list of phone numbers. |
 |  |  |  | type | String | Phone number type. |
 |  |  |  | country | String | Phone number country. |
 |  |  |  | area | String | Phone number area code. |
 |  |  |  | number | String | Phone number. |
 |  | rooms |  |  | Array | A list of rooms associated with the booking. |
 |  |  | index |  | String | The index of the room in the list of rooms. |
 |  |  | status |  | String | Status of the room reservation. |
 |  |  | roomID |  | String | The internal roomID of the room. |
 |  |  | code |  | String | The internal code of the room. |
 |  |  | name |  | String | The name of the room. |
 |  |  | guestName |  | Object | Details of the guest name. |
 |  |  |  | title | String | Guest title. |
 |  |  |  | first | String | Guest first name. |
 |  |  |  | last | String | Guest last name. |
 |  |  | guestEmail |  |  | Guest email address. |
 |  |  | adults |  |  | The number of adults booked in the room. |
 |  |  | children |  |  | The number of children booked in the room. |
 |  |  | infants |  |  | The number of infants booked in the room. |
 |  |  | checkinDate |  |  | The checkin date for the room reservation. |
 |  |  | checkoutDate |  |  | The checkout date for the room reservation. |
 |  |  | nights |  |  | The number of nights the room is booked for. |
 |  |  | currency |  |  | The currency used while booking the room. |
 |  |  | reservationTotal |  |  | Total cost of the room reservation, including taxes/fees. |
 |  |  | taxesAndFeesTotal |  |  | Taxes and fees paid during the room reservation. |
 |  |  | accommodationTotal |  |  | Cost of the room with extras excluded. |
 |  |  | comments |  |  | Comments made on the room reservation. |
 |  |  | upsells |  | Array | Array of upsells pruchsed. |
 |  |  |  | name | String | The name of the upsell. |
 |  |  |  | description | String | The upsell description. |
 |  |  |  | quantity | Integer | The number of this upsell purchased. |
 |  |  |  | itemPrice | String | Price of each individual upsell. |
 |  |  |  | total | String | Total amount paid paid based on quantity and itemPrice. |
status | Â | Â | Â | Â | String | Response status. |
Sample
{
"siteList": [
{
"siteID": "1853",
"primaryName": "TestHotel Mahony",
"transactions": [
{
"reference": "6YP6UCL",
"dtCreated": "2024-04-25 08:39:02",
"dtLastChanged": "2024-04-25 08:39:02",
"status": "new",
"newsletterSignup": "yes",
"currency": "EUR",
"total": "150.00",
"subTotal": "150.00",
"taxesAndFees": "0.00",
"moneyTaken": "50.00",
"rate": {
"rateID": "4208974",
"code": "BARRO",
"name": "Best Available Rate Room Only"
},
"booker": {
"name": {
"title": "Mr",
"first": "Martin",
"last": "Mahony"
},
"email": "martin.mahony@shrgroup.com",
"selectedLanguage": "en",
"address": {
"line1": "Lonsdale Road National Technology Park",
"line2": "",
"townCity": "Castletroy",
"postCode": "V94 AW2X",
"countyState": "Limerick",
"countryCode": "IE"
},
"phones": [
{
"index": 0,
"type": "unknown",
"country": "",
"area": "",
"number": "+353 61335680"
}
]
},
"rooms": [
{
"index": 1,
"status": "active",
"roomID": "4194373",
"code": "SGL",
"name": "Single Room",
"guestName": {
"title": "Mr",
"first": "Martin",
"last": "Mahony"
},
"guestEmail": "martin.mahony@shrgroup.com",
"adults": 1,
"children": 0,
"infants": 0,
"checkinDate": "2024-04-25",
"checkoutDate": "2024-04-26",
"nights": 1,
"currency": "EUR",
"reservationTotal": "150.00",
"taxesAndFeesTotal": "0.00",
"accommodationTotal": "150.00",
"comments": "",
"upsells": []
}
]
},
{
"reference": "3948484",
"dtCreated": "2024-04-25 08:40:59",
"dtLastChanged": "2024-04-25 08:40:59",
"status": "new",
"newsletterSignup": "yes",
"currency": "EUR",
"total": "150.00",
"subTotal": "150.00",
"taxesAndFees": "0.00",
"moneyTaken": "50.00",
"rate": {
"rateID": "4208974",
"code": "BARRO",
"name": "Best Available Rate Room Only"
},
"booker": {
"name": {
"title": "Mr",
"first": "Martin",
"last": "Mahony"
},
"email": "martin.mahony@shrgroup.com",
"selectedLanguage": "en",
"address": {
"line1": "Lonsdale Road National Technology Park",
"line2": "",
"townCity": "Castletroy",
"postCode": "V94 AW2X",
"countyState": "Limerick",
"countryCode": "IE"
},
"phones": [
{
"index": 0,
"type": "unknown",
"country": "",
"area": "",
"number": "+353 61335680"
}
]
},
"rooms": [
{
"index": 1,
"status": "active",
"roomID": "4194373",
"code": "SGL",
"name": "Single Room",
"guestName": {
"title": "Mr",
"first": "Martin",
"last": "Mahony"
},
"guestEmail": "martin.mahony@shrgroup.com",
"adults": 1,
"children": 0,
"infants": 0,
"checkinDate": "2024-04-25",
"checkoutDate": "2024-04-26",
"nights": 1,
"currency": "EUR",
"reservationTotal": "150.00",
"taxesAndFeesTotal": "0.00",
"accommodationTotal": "150.00",
"comments": "",
"upsells": []
}
]
}
]
}
],
"status": "ok"
}