Hotel Availability


Get Hotels availability list

Description

Returns Hotels information at the specified destination parameter. You need to send dates and passenger information.

Request

URI

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

Verb

GET

Parameters

language string
currency string
destinationId string
destinationType integer (3 - Destination, 6 - City)
hotelIds integer array
arrivalDate date
departureDate date
rooms[].adults integer
rooms[].childAges integer array

Headers

Accept (optional)

Response

Response code

200 (OK)

Body

XML

<ArrayOfBaseHotel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/PriceTravel.Api.Model.Common">
   <BaseHotel xmlns:d2p1="http://schemas.datacontract.org/2004/07/PriceTravel.Api.Model.External" i:type="d2p1:HotelSummary">
      <Id>integer</Id>
      <LowestAverageRate>decimal</LowestAverageRate>
      <Name>string</Name>
      <Uri>string</Uri>
      <d2p1:HotelInformation>
         <Address>string</Address>
         <Category>integer</Category>
         <Chain>string</Chain>
         <City>string</City>
         <Country>string</Country>
         <CountryCode>string</CountryCode>
         <DestinationId>integer</DestinationId>
         <HotelImageUri>string</HotelImageUri>
         <LogoUri>string</LogoUri>
         <Title>string</Title>
         <ShortDescription>string</ShortDescription>
         <State>string</State>
         <TotalRooms>integer</TotalRooms>
         <ZipCode>integer</ZipCode>
         <d2p1:Services />
      </d2p1:HotelInformation>
      <d2p1:RatePlans>
         <d2p1:RateSummary>
            <d2p1:RatePlanId>integer</d2p1:RatePlanId>
            <d2p1:RoomId>ineteger</d2p1:RoomId>
            <d2p1:Currency>string</d2p1:Currency>
            <d2p1:MealPlanId>string</d2p1:MealPlanId>
            <d2p1:ResortFee>decimal</d2p1:ResortFee>
            <d2p1:RoomName>string</d2p1:RoomName>
            <d2p1:RoomRates>
               <RoomRate>
                  <AverageRate>decimal</AverageRate>
                  <AverageRateWithTax>decimal</AverageRateWithTax>
                  <BaseRate>decimal</BaseRate>
                  <DailyRates>
                     <d2p1:DailyRate>
                        <d2p1:AdultsPrice>decimal</d2p1:AdultsPrice>
                        <d2p1:Amount>decimal</d2p1:Amount>
                        <d2p1:HospitalityTax>decimal</d2p1:HospitalityTax>
                        <d2p1:PrePromotionalRate>decimal</d2p1:PrePromotionalRate>
                        <d2p1:PromotionDiscount>decimal</d2p1:PromotionDiscount>
                        <d2p1:PromotionMessage>string</d2p1:PromotionMessage>
                        <d2p1:StayDate>date</d2p1:StayDate>
                        <d2p1:Tax>decimal</d2p1:Tax>
                     </d2p1:DailyRate>
                  </DailyRates>
                  <PromotionDescription>string</PromotionDescription>
                  <Tax>decimal</Tax>
                  <TotalAmount>decimal</TotalAmount>
               </RoomRate>
            </d2p1:RoomRates>
            <d1p1:CancellationPolicies>
               <CancellationPolicy>
                  <PenaltyAmount>decimal</Penalty>
                  <Percentage>decimal</Percentage>
                  <NonRefundable>boolean</StartDate>
                  <WithInDays>integer</WithInDays>
               </CancellationPolicy>
            </d1p1:CancellationPolicies>
            <d2p1:TotalAmount>decimal</d2p1:TotalAmount>
            <d2p1:TotalComission>decimal</d2p1:TotalComission>
         </d2p1:RateSummary>
      </d2p1:RatePlans>
   </BaseHotel>   
</ArrayOfBaseHotel>

JSON

[
    {
        "Id": integer,
        "Name": string,
        "Uri": string,
        "LowestAverageRate": decimal,
        "HotelInformation": {
            "Title": string,
            "ShortDescription": string,
            "Address": string,
            "City": string,
            "State": string,
            "CountryCode": string,
            "Country": string,
            "Chain": string,
            "DestinationId": integer,
            "ZipCode": string,
            "TotalRooms": integer,
            "Category": integer,
            "LogoUri": string,
            "HotelImageUri": string
        },
        "RatePlans": [
            {
                "RatePlanId": integer,
                "RoomId": integer,
                "MealPlanId": string,
                "ResortFee": decimal,
                "TotalAmount": 28667.808
                "TotalComission": decimal,
                "Currency": string,
                "RoomRates": [
                    {
                        "TotalAmount": decimal,
                        "Tax": decimal,
                        "BaseRate": decimal,
                        "AverageRate": decimal,
                        "AverageRateWithTax": decimal,
                        "DailyRates": [
                            {
                                "PrePromotionalRate": decimal,
                                "AdultsPrice": decimal,
                                "KidsPrice": decimal,
                                "Tax": decimal,
                                "HospitalityTax": decimal,
                                "Amount": decimal,
                                "PromotionDiscount": decimal,
                                "PromotionMessage": string,
                                "StayDate": date
                            }
                        ]
                    }
                ],
                "CancellationPolicies": [
                   {
                      "WithInDays": integer,
                      "NonRefundable": boolean,
                      "PenaltyAmount": decimal,
                      "Percentage": decimal
                   }
                ]
            }
        ]
    }
]

401 (Unauthorized)

Invalid “Authorization” header.

Get Hotel availability

Description

Returns Hotel availability information specified in the destination parameter. You need to send dates and passenger information.

Request

URI

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

Verb

GET

Parameters

language string
currency string
arrivalDate date
departureDate date
rooms[].adults integer
rooms[].childAges integer array

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:HotelSummary">
      <Id>integer</Id>
      <LowestAverageRate>decimal</LowestAverageRate>
      <Name>string</Name>
      <Uri>string</Uri>
      <d2p1:HotelInformation>
         <Address>string</Address>
         <Category>integer</Category>
         <Chain>string</Chain>
         <City>string</City>
         <Country>string</Country>
         <CountryCode>string</CountryCode>
         <DestinationId>integer</DestinationId>
         <HotelImageUri>string</HotelImageUri>
         <LogoUri>string</LogoUri>
         <Title>string</Title>
         <ShortDescription>string</ShortDescription>
         <State>string</State>
         <TotalRooms>integer</TotalRooms>
         <ZipCode>integer</ZipCode>
         <d2p1:Services />
      </d2p1:HotelInformation>
      <d2p1:RatePlans>
         <d2p1:RateSummary>
            <d2p1:RatePlanId>integer</d2p1:RatePlanId>
            <d2p1:RoomId>ineteger</d2p1:RoomId>
            <d2p1:Currency>string</d2p1:Currency>
            <d2p1:MealPlanId>string</d2p1:MealPlanId>
            <d2p1:ResortFee>decimal</d2p1:ResortFee>
            <d2p1:RoomName>string</d2p1:RoomName>
            <d2p1:RoomRates>
               <RoomRate>
                  <AverageRate>decimal</AverageRate>
                  <AverageRateWithTax>decimal</AverageRateWithTax>
                  <BaseRate>decimal</BaseRate>
                  <DailyRates>
                     <d2p1:DailyRate>
                        <d2p1:AdultsPrice>decimal</d2p1:AdultsPrice>
                        <d2p1:Amount>decimal</d2p1:Amount>
                        <d2p1:HospitalityTax>decimal</d2p1:HospitalityTax>
                        <d2p1:PrePromotionalRate>decimal</d2p1:PrePromotionalRate>
                        <d2p1:PromotionDiscount>decimal</d2p1:PromotionDiscount>
                        <d2p1:PromotionMessage>string</d2p1:PromotionMessage>
                        <d2p1:StayDate>date</d2p1:StayDate>
                        <d2p1:Tax>decimal</d2p1:Tax>
                     </d2p1:DailyRate>
                  </DailyRates>
                  <PromotionDescription>string</PromotionDescription>
                  <Tax>decimal</Tax>
                  <TotalAmount>decimal</TotalAmount>
               </RoomRate>
            </d2p1:RoomRates>
            <d1p1:CancellationPolicies>
               <CancellationPolicy>
                  <PenaltyAmount>decimal</Penalty>
                  <Percentage>decimal</Percentage>
                  <NonRefundable>boolean</StartDate>
                  <WithInDays>integer</WithInDays>
               </CancellationPolicy>
            </d1p1:CancellationPolicies>
            <d2p1:TotalAmount>decimal</d2p1:TotalAmount>
            <d2p1:TotalComission>decimal</d2p1:TotalComission>
         </d2p1:RateSummary>
      </d2p1:RatePlans>
   </BaseHotel>   

JSON

   {
        "Id": integer,
        "Name": string,
        "Uri": string,
        "LowestAverageRate": decimal,
        "HotelInformation": {
            "Title": string,
            "ShortDescription": string,
            "Address": string,
            "City": string,
            "State": string,
            "CountryCode": string,
            "Country": string,
            "Chain": string,
            "DestinationId": integer,
            "ZipCode": string,
            "TotalRooms": integer,
            "Category": integer,
            "LogoUri": string,
            "HotelImageUri": string
        },
        "RatePlans": [
            {
                "RatePlanId": integer,
                "RoomId": integer,
                "MealPlanId": string,
                "ResortFee": decimal,
                "TotalAmount": 28667.808
                "TotalComission": decimal,
                "Currency": string,
                "RoomRates": [
                    {
                        "TotalAmount": decimal,
                        "Tax": decimal,
                        "BaseRate": decimal,
                        "AverageRate": decimal,
                        "AverageRateWithTax": decimal,
                        "DailyRates": [
                            {
                                "PrePromotionalRate": decimal,
                                "AdultsPrice": decimal,
                                "KidsPrice": decimal,
                                "Tax": decimal,
                                "HospitalityTax": decimal,
                                "Amount": decimal,
                                "PromotionDiscount": decimal,
                                "PromotionMessage": string,
                                "StayDate": date
                            }
                        ]
                    }
                ],
                "CancellationPolicies": [
                   {
                      "WithInDays": integer,
                      "NonRefundable": boolean,
                      "PenaltyAmount": decimal,
                      "Percentage": decimal
                   }
                ]
            }
        ]
    }

401 (Unauthorized)

Invalid “Authorization” header.