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"
}