Hotel API Endpoints

Travelport is updating the authentication and authorization endpoints for all JSON APIs and providing new credentials. All customers either already have received or will receive new credentials and have or will be migrated to the new endpoints. If your company has not yet migrated to new credentials, continue to use your existing credentials and endpoints. See Authentication for migration details.

This topic provides a consolidated list of endpoints and associated methods for all Hotel APIs. For links to all topics see the Hotel API Reference List.

See Common Hotel API Headers for the header parameters that must be sent with all requests.

In this topic:

Authentication
Base Path for all Hotel APIs
JSON Hotel API Endpoints List

Authentication

Travelport is updating the authentication and authorization endpoints for all JSON APIs and providing new application credentials to all customers. See Authentication for migration details.

Use these endpoints for authentication requests if you haven't received or haven't migrated to the new credentials from Travelport:

Pre-production https://oauth.pp.travelport.com/oauth/oauth20/token

Production https://oauth.travelport.com/oauth/oauth20/token

Use these endpoints for authentication requests after you have migrated to the new credentials from Travelport:

Pre-production https://auth.pp.travelport.net/oauth/token

Production https://auth.travelport.net/oauth/token

Base Path for All Hotel APIs

Combine the appropriate base path below with all Hotel API authorization endpoints in the next section.

Use this base path if you have not yet received or not migrated to the new credentials from Travelport:

Pre-production https://api.pp.travelport.com/11/hotel/ | Production https://api.travelport.com/11/hotel/

Use this base path after you have migrated to the new credentials from Travelport (using .net instead of .com):

Pre-production https://api.pp.travelport.net/11/hotel/ | Production https://api.travelport.net/11/hotel/

For example, the complete post-migration endpoint for the Hotel Availability API in the production environment is

https://api.travelport.net/11/hotel/availability/catalogofferingshospitality

JSON Hotel API Endpoints

The following tables lists the endpoint for each Hotel API and links to the corresponding API reference. All APIs are v11 unless noted as v12 (what's the difference?). The endpoint includes any required query parameters.

Request	Endpoint (add to Base Path above)
Search by ID	POST search/properties
Search by Location	POST search/properties/search
Search Pagination	GET search/properties/{SearchIdentifier}?pageNumber={x}
SearchComplete (v12)	POST search/searchcomplete/
SearchComplete Pagination (v12)	GET search/searchcomplete/{SearchIdentifier}?pageNumber={x}
Hotel Details	GET search/propertiesdetail?chainCode={xy}&propertyCode={12345}
Hotel Availability	POST availability/catalogofferingshospitality
Hotel Availability Pagination	POST availability/catalogofferingshospitality/{SearchIdentifier}?pageNumber={x}
Hotel Rules (full payload)	POST rules/offershospitality/buildfromrequest
Hotel Rules (reference payload)	POST rules/offershospitality/buildfromcatalogoffering
Create Reservation (full payload)	POST book/reservations
Create Reservation (reference payload)	POST book/reservations/build
Retrieve hotel reservation	GET book/reservations/{AggregatorLocatorCode}
Modify hotel reservation	PUT book/reservations/{AggregatorLocatorCode}
Cancel hotel reservation	PUT book/reservations/{AggregatorLocatorCode}/canceloffer?supplierLocator={SupplierLocatorCode}
Add reservation to existing reservation (full payload and reference payload use the same endpoint)	PUT book/reservations/{AggregatorLocatorCode}
Create passive hotel reservation	POST book/reservations/passive
Add passive hotel reservation to existing reservation	PUT book/reservations/{AggregatorLocatorCode}/passive
Modify passive hotel reservation	PUT book/reservations/{AggregatorLocatorCode}/passiveupdate
Sync hotel reservation	POST book/reservations/