Check the Hotel Release Notes for updates across all Hotel APIs.
Retrieve Hotel Reservation API Reference
|
Get |
book/reservations/{LocatorCode} For {LocatorCode} send the locator code of the reservation to retrieve. Base path: Use this base path if you have not yet received or not migrated to the new credentials from Travelport:
Use this base path after you have migrated to the new credentials from Travelport (using .net instead of .com):
|
Related Content: Hotel Guide, Create Hotel Reservation API Reference
The Hotel Retrieve API returns traveler and hotel reservation information from an existing PNR in the Travelport system.
Request
Also see Authentication and Common Air Headers.
Query Parameters
None.
Request Body
None.
Response
The response to the Retrieve Reservation request returns the updated information using the same structure as the response to Create Reservation.
Example Request
GET https://api.pp.travelport.com/11/hotel/book/reservations/2BQ55R
Example Response
Show Example Response
{
"ReservationResponse": {
"Reservation": {
"@type": "ReservationDetail",
"id": "513ea814-8a27-4145-a1df-ee07fb34d824",
"Offer": [
{
"@type": "Offer",
"id": "O1",
"Identifier": {
"authority": "EXPE"
},
"Product": [
{
"@type": "ProductHospitality",
"Quantity": 1,
"bookingCode": "C2D0007",
"guests": 1,
"PropertyKey": {
"chainCode": "BX",
"propertyCode": "16798"
},
"DateRange": {
"start": "2022-11-11",
"end": "2022-11-14"
}
}
],
"Price": {
"@type": "PriceDetail",
"CurrencyCode": {
"value": "DKK",
"decimalPlace": 2
},
"TotalPrice": 1650.0
},
"TermsAndConditionsFull": [
{
"@type": "TermsAndConditionsFullHospitality",
"Guarantee": [
{
"guaranteeType": "GuaranteeRequired"
}
],
"CancelPenalty": [
{
"Deadline": {
"SpecificDate": {
"start": "2022-09-09",
"end": "2022-11-10"
},
"Time": "18:00:00"
},
"HotelPenalty": {
"@type": "HotelPenaltyAmount",
"Amount": [
{
"value": 0.0,
"code": "DKK"
}
]
},
"Refundable": "Yes"
},
{
"Deadline": {
"SpecificDate": {
"start": "2022-11-10"
},
"Time": "18:00:00"
},
"HotelPenalty": {
"@type": "HotelPenaltyAmount",
"Amount": [
{
"value": 550.0,
"code": "DKK"
}
]
},
"Refundable": "No"
}
],
"RatePaymentInfo": "PostPay"
}
]
},
{
"@type": "Offer",
"id": "O2",
"Identifier": {
"authority": "TVPT"
},
"Product": [
{
"@type": "ProductHospitality",
"Quantity": 1,
"bookingCode": "C2D0007",
"guests": 1,
"PropertyKey": {
"chainCode": "BX",
"propertyCode": "16798"
},
"DateRange": {
"start": "2022-11-11",
"end": "2022-11-14"
}
}
],
"Price": {
"@type": "PriceDetail",
"CurrencyCode": {
"value": "DKK",
"decimalPlace": 2
},
"TotalPrice": 1650.0
},
"TermsAndConditionsFull": [
{
"@type": "TermsAndConditionsFullHospitality",
"Guarantee": [
{
"guaranteeType": "GuaranteeRequired"
}
],
"CancelPenalty": [
{
"Deadline": {
"SpecificDate": {
"start": "2022-09-09",
"end": "2022-11-10"
},
"Time": "18:00:00"
},
"HotelPenalty": {
"@type": "HotelPenaltyAmount",
"Amount": [
{
"value": 0.0,
"code": "DKK"
}
]
},
"Refundable": "Yes"
},
{
"Deadline": {
"SpecificDate": {
"start": "2022-11-10"
},
"Time": "18:00:00"
},
"HotelPenalty": {
"@type": "HotelPenaltyAmount",
"Amount": [
{
"value": 550.0,
"code": "DKK"
}
]
},
"Refundable": "No"
}
],
"RatePaymentInfo": "PostPay"
}
]
},
{
"@type": "Offer",
"id": "O3",
"Identifier": {
"authority": "TVPT"
},
"Product": [
{
"@type": "ProductHospitality",
"Quantity": 1,
"bookingCode": "C2D0007",
"guests": 1,
"PropertyKey": {
"chainCode": "BX",
"propertyCode": "16798"
},
"DateRange": {
"start": "2022-11-14",
"end": "2022-11-15"
}
}
],
"Price": {
"@type": "PriceDetail",
"CurrencyCode": {
"value": "DKK",
"decimalPlace": 2
},
"TotalPrice": 1650.0
},
"TermsAndConditionsFull": [
{
"@type": "TermsAndConditionsFullHospitality",
"Guarantee": [
{
"guaranteeType": "GuaranteeRequired"
}
],
"CancelPenalty": [
{
"Deadline": {
"SpecificDate": {
"start": "2022-09-09",
"end": "2022-11-10"
},
"Time": "18:00:00"
},
"HotelPenalty": {
"@type": "HotelPenaltyAmount",
"Amount": [
{
"value": 0.0,
"code": "DKK"
}
]
},
"Refundable": "Yes"
},
{
"Deadline": {
"SpecificDate": {
"start": "2022-11-10"
},
"Time": "18:00:00"
},
"HotelPenalty": {
"@type": "HotelPenaltyAmount",
"Amount": [
{
"value": 550.0,
"code": "DKK"
}
]
},
"Refundable": "No"
}
],
"RatePaymentInfo": "PostPay"
}
]
}
],
"Traveler": [
{
"@type": "Traveler",
"id": "T1",
"PersonName": {
"@type": "PersonName",
"Given": "NAMEA",
"Surname": "SURNAMEA"
},
"Telephone": [
{
"@type": "Telephone",
"phoneNumber": "011-11111111",
"cityCode": "DEN"
},
{
"@type": "Telephone",
"phoneNumber": "011-222222222",
"cityCode": "DEN"
},
{
"@type": "Telephone",
"phoneNumber": "011-333333333",
"cityCode": "DEN"
}
],
"Email": [
{
"value": "test1@test.com"
}
],
"CustomerLoyalty": [
{
"value": "ogramId1Value1",
"programId": "Pr"
}
]
},
{
"@type": "Traveler",
"id": "T2",
"PersonName": {
"@type": "PersonName",
"Given": "NAMEB",
"Surname": "SURNAMEB"
},
"Email": [
{
"value": "test2@test.com"
}
]
},
{
"@type": "Traveler",
"id": "T3",
"PersonName": {
"@type": "PersonName",
"Given": "NAMEC",
"Surname": "SURNAMEC"
},
"Email": [
{
"value": "test3@test.com"
}
]
}
],
"TravelerProduct": [
{
"@type": "TravelerProduct",
"TravelerRef": "T2",
"OfferRef": "O1"
}
},
{
"@type": "TravelerProduct",
"TravelerRef": "T1",
"OfferRef": "O2"
}
},
{
"@type": "TravelerProduct",
"TravelerRef": "T3",
"OfferRef": "O3"
}
}
],
"Receipt": [
{
"@type": "ReceiptConfirmation",
"OfferRef": [
"O1"
],
"Confirmation": {
"@type": "ConfirmationHold",
"Locator": {
"value": "GAL784155606",
"locatorType": "Confirmation Number",
"source": "BX",
"sourceContext": "Supplier"
},
"OfferStatus":
"@type": "OfferStatusHospitality",
"Status": "Confirmed"
}
}
},
{
"@type": "ReceiptConfirmation",
"OfferRef": [
"O2"
],
"Confirmation": {
"@type": "ConfirmationHold",
"Locator": {
"value": "GAL144635594",
"locatorType": "Confirmation Number",
"source": "BX",
"sourceContext": "Supplier"
},
"OfferStatus": {
"@type": "OfferStatusHospitality",
"Status": "Confirmed"
}
}
},
{
"@type": "ReceiptConfirmation",
"OfferRef": [
"O3"
],
"Confirmation": {
"@type": "ConfirmationHold",
"Locator": {
"value": "GAL328547179",
"locatorType": "Confirmation Number",
"source": "BX",
"sourceContext": "Supplier"
},
"OfferStatus": {
"@type": "OfferStatusHospitality",
"Status": "Confirmed"
}
}
},
{
"@type": "ReceiptConfirmation",
"Confirmation": {
"@type": "ConfirmationHold",
"Locator": {
"value": "2BQ55R",
"locatorType": "PNR Locator",
"sourceContext": "Travelport"
},
"OfferStatus": {
"@type": "OfferStatusHospitality",
"Status": "Confirmed"
}
}
}
],
"ReservationComment": [
{
"@type": "ReservationComment",
"Comment": [
{
"value": "Please dont charge CC"
}
],
"AppliesTo": [
{
"@type": "AppliesToOffer",
"OfferIdentifier": [
{
"@type": "OfferID",
"offerRef": "O1"
}
]
}
]
},
{
"@type": "ReservationComment",
"Comment": [
{
"value": "Please dont charge CC modified"
}
],
"AppliesTo": [
{
"@type": "AppliesToOffer",
"OfferIdentifier": [
{
"@type": "OfferID",
"offerRef": "O2"
}
]
}
]
},
{
"@type": "ReservationComment",
"Comment": [
{
"value": "lower floor room please Test"
}
],
"AppliesTo": [
{
"@type": "AppliesToOffer",
"OfferIdentifier": [
{
"@type": "OfferID",
"offerRef": "O3"
}
]
}
]
}
]
}
}
}
Error Messages
Error message for Hotel Retrieve API.
Show Error Messages
| SourceCode | StatusCode (HTTP code) | Message |
|---|---|---|
|
|
400 |
Not able to reach IDM Authorization atomic or Authorization cannot be identified due to insufficient inputs |
|
|
400 |
Provider Locator must be provided. |
|
|
400 |
Unable to process Retrieve request: Invalid Record Locator Number. |
|
|
401 |
Unathorised user. |
|
|
500 |
null |