Operations on Hotels


Get Hotel List

Description

Returns a paginated Hotel list at the Destination specified as parameter. Do not require quotation parameters such as dates and number of adults. The Response includes the cheapest average night rate for the next two months (quoting 3 nights for 2 adults).

Request

URI

https://api.pricetravel.com/services/hotels

Verb

GET

Parameters

  • language: string
  • currency: string
  • destinationId: string
  • hotelIds: integer array

Headers

Accept (optional)

Response

Response code

200 (OK)

Body

XML

<Hotels>
 <BaseHotel xmlns:d2p1="http://schemas.datacontract.org/2004/07/PriceTravel.Api.Model.External" i:type="d2p1:Hotel">
   <Id>integer</Id>
   <Name>string</Name>
   <Uri>string</Uri>
   <d2p1:HotelInformation>
      <Address>string</Address>
      <Category>integer</Category>
      <Chain></Chain>
      <ChainId i:nil="true" />
      <City>string</City>
      <Country>string</Country>
      <CountryCode>string</CountryCode>
      <Description>string</Description>
      <DestinationId>integer</DestinationId>
      <HotelImageUri>string</HotelImageUri>
      <d1p1:Services>
         <HotelService>
            <Id>integer</Id>
            <Service>string</Service>
         </HotelService>
      </d1p1:Services>
      <LogoUri>string</LogoUri>
      <State>string</State>
      <TotalRooms>integer</TotalRooms>
      <ZipCode>string</ZipCode>
   </d2p1:HotelInformation>
   <d2p1:Images>
      <Image>
         <Caption>string</Caption>
         <ImageUri>string</ImageUri>
         <ThumbnailUri>string</ThumbnailUri>
      </Image>
   </d2p1:Images>
   <d2p1:IsActive>true</d2p1:IsActive>
   <d2p1:Rooms>
      <d2p1:Room>
         <d2p1:AgeKidsFreeFrom>integer</d2p1:AgeKidsFreeFrom>
         <d2p1:AgeKidsFreeTo>integer</d2p1:AgeKidsFreeTo>
         <d2p1:AgeKidsUpTo>integer</d2p1:AgeKidsUpTo>
         <d2p1:AmenityIds xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" i:nil="true" />
         <d2p1:Bedding>string</d2p1:Bedding>
         <d2p1:CheckInTime>string</d2p1:CheckInTime>
         <d2p1:CheckOutTime>string</d2p1:CheckOutTime>
         <d2p1:Id>integer</d2p1:Id>
         <d2p1:MaximumAdultOccupancy>integer</d2p1:MaximumAdultOccupancy>
         <d2p1:MaximumJuniorOccupancy>integer</d2p1:MaximumJuniorOccupancy>
         <d2p1:MaximumMinorOccupancy>integer</d2p1:MaximumMinorOccupancy>
         <d2p1:MaximumRoomOccupancy>integer</d2p1:MaximumRoomOccupancy>
         <d2p1:MinimumGuestAge>integer</d2p1:MinimumGuestAge>
         <d2p1:Name>string</d2p1:Name>
         <d2p1:RoomView>string</d2p1:RoomView>
         <d2p1:ThumbnailUri>string</d2p1:ThumbnailUri>
      </d2p1:Room>
   </d2p1:Rooms>
</BaseHotel>
 </Hotels>

JSON

[{
    "Id": integer,
    "Name": string,
    "Uri": string,
    "IsActive": boolean,
    "HotelInformation": {
        "Services": [
            {
                "Id": integer,
                "Service": string
            }
        ],
        "Address": string,
        "City": string,
        "State": string,
        "CountryCode": string,
        "Country": string,
        "ChainId": integer,
        "Chain": string,
        "DestinationId": integer,
        "ZipCode": string,
        "TotalRooms": integer,
        "Category": integer,
        "Description": string,
        "LogoUri": string,
        "HotelImageUri": string
    },
    "Rooms": [
        {
            "Amenities": [
                {
                    "Id": integer,
                    "Name": string
                }
            ],
            "Id": integer,
            "ThumbnailUri": string,
            "Name": string,
            "MaximumRoomOccupancy": integer,
            "MaximumMinorOccupancy": integer,
            "MaximumAdultOccupancy": integer,
            "MaximumJuniorOccupancy": integer,
            "MinimumGuestAge": integer,
            "AgeKidsUpTo": integer,
            "AgeKidsFreeFrom": integer,
            "AgeKidsFreeTo": integer,
            "CheckInTime": string,
            "CheckOutTime": string,
            "Bedding": string,
            "RoomView": string,
        }
    ],
    "Images": [
        {
            "ThumbnailUri": string,
            "ImageUri": string,
            "Caption": string
        }
    ],
    "AverageRateWithTax": integer
}]

Errors

401 (Unauthorized)

Invalid “Authorization” header.

Get specific Hotel

Description

Returns the hotel detailed information for the requested hotel. It includes location, descriptions, services, amenities and images. The response includes the cheapest average night rate for the next two months (quoting 3 nights for 2 adults).

Request

URI

https://api.pricetravel.com/services/hotels/{hotelId}

Verb

GET

Parameters

  • language: string
  • currency: string

Headers

Accept (optional)

Response

Response code

200 (OK)

Body

XML

<BaseHotel xmlns:d2p1="http://schemas.datacontract.org/2004/07/PriceTravel.Api.Model.External" i:type="d2p1:Hotel">
<Id>integer</Id>
<Name>string</Name>
<Uri>string</Uri>
<d2p1:HotelInformation>
<Address>string</Address>
<Category>integer</Category>
<Chain></Chain>
<ChainId i:nil="true" />
<City>string</City>
<Country>string</Country>
<CountryCode>string</CountryCode>
<Description>string</Description>
<DestinationId>integer</DestinationId>
<HotelImageUri>string</HotelImageUri>
<HotelServices>
<AllInclusivePlan xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
<Bars xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
<ExtraChargeServices xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
<IncludedServices xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
<NightClubs xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
<Restaurants xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
</HotelServices>
<LogoUri>string</LogoUri>
<State>string</State>
<TotalRooms>integer</TotalRooms>
<ZipCode>string</ZipCode>
</d2p1:HotelInformation>
<d2p1:Images>
<Image>
<Caption>string</Caption>
<ImageUri>string</ImageUri>
<ThumbnailUri>string</ThumbnailUri>
</Image>
</d2p1:Images>
<d2p1:IsActive>true</d2p1:IsActive>
<d2p1:RatePlans i:nil="true" />
<d2p1:Rooms>
<d2p1:Room>
<d2p1:AgeKidsFreeFrom>integer</d2p1:AgeKidsFreeFrom>
<d2p1:AgeKidsFreeTo>integer</d2p1:AgeKidsFreeTo>
<d2p1:AgeKidsUpTo>integer</d2p1:AgeKidsUpTo>
<d2p1:AmenityIds xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" i:nil="true" />
<d2p1:Bedding>string</d2p1:Bedding>
<d2p1:CheckInTime>string</d2p1:CheckInTime>
<d2p1:CheckOutTime>string</d2p1:CheckOutTime>
<d2p1:Id>integer</d2p1:Id>
<d2p1:MaximumAdultOccupancy>integer</d2p1:MaximumAdultOccupancy>
<d2p1:MaximumJuniorOccupancy>integer</d2p1:MaximumJuniorOccupancy>
<d2p1:MaximumMinorOccupancy>integer</d2p1:MaximumMinorOccupancy>
<d2p1:MaximumRoomOccupancy>integer</d2p1:MaximumRoomOccupancy>
<d2p1:MinimumGuestAge>integer</d2p1:MinimumGuestAge>
<d2p1:Name>string</d2p1:Name>
<d2p1:RoomView>string</d2p1:RoomView>
<d2p1:ThumbnailUri>string</d2p1:ThumbnailUri>
</d2p1:Room>
</d2p1:Rooms>
</BaseHotel>

JSON

{
    "Id": integer,
    "Name": string,
    "Uri": string,
    "IsActive": boolean,
    "HotelInformation": {
        "Services": [
            {
                "Id": integer,
                "Service": string
            }
        ],
        "Address": string,
        "City": string,
        "State": string,
        "CountryCode": string,
        "Country": string,
        "ChainId": integer,
        "Chain": string,
        "DestinationId": integer,
        "ZipCode": string,
        "TotalRooms": integer,
        "Category": integer,
        "Description": string,
        "LogoUri": string,
        "HotelImageUri": string
    },
    "Rooms": [
        {
            "Amenities": [
                {
                    "Id": integer,
                    "Name": string
                }
            ],
            "Id": integer,
            "ThumbnailUri": string,
            "Name": string,
            "MaximumRoomOccupancy": integer,
            "MaximumMinorOccupancy": integer,
            "MaximumAdultOccupancy": integer,
            "MaximumJuniorOccupancy": integer,
            "MinimumGuestAge": integer,
            "AgeKidsUpTo": integer,
            "AgeKidsFreeFrom": integer,
            "AgeKidsFreeTo": integer,
            "CheckInTime": string,
            "CheckOutTime": string,
            "Bedding": string,
            "RoomView": string,
        }
    ],
    "Images": [
        {
            "ThumbnailUri": string,
            "ImageUri": string,
            "Caption": string
        }
    ],
    "AverageRateWithTax": integer
}

Errors

401 (Unauthorized)

Invalid “Authorization” header.

404 (Not found)

A hotel with the specified id could not be found.