HOTEL API

HOTEL API BY GOALLTRIP.COM


GET: https://www.goalltrip.com/api/hotel/citylist.php?gatkey=gatkey
    

[
  {
    "hcity": "Agartala,Tripura,India",
    "id": "1"
  },
  {
    "hcity": "Agra,UttarPradesh,India",
    "id": "2"
  },
  {
    "hcity": "Ahmadnagar,Maharashtra,India",
    "id": "3"
  },
  {
    "hcity": "Ahmedabad,Gujarat,India",
    "id": "4"
  },
  {
    "hcity": "Ajmer,Rajasthan,India",
    "id": "5"
  },
  {
    "hcity": "Alleppey,Kerala,India",
    "id": "6"
  },
  {
    "hcity": "Allahabad,UttarPradesh,India",
    "id": "7"
  },
  
  ]

    

GET: https://www.goalltrip.com/api/hotel/hotel_search.php?gatkey=gatkey&city=Chennai,TamilNadu,India&CheckIn=11/21/2016&CheckOut=11/22/2016&RoomInfo=1,2,0,~0,|

S.No Attribute Descriptions Required
1 gatkey gatkey (provided by Goalltrip) true
2 city Requires City name true
3 CheckIn Date format mm/dd/yyyy true
4 CheckOut Date format mm/dd/yyyy true
5 RoomInfo 1,2,1,~5,| 1 – Room Count 2 – Adult Count 1 – Child Count 5 – Child Age true

    
  

Hotel Search Response

{ "SearchData": { "MultipleHotels": { "Rate": { "LowRate": "0", "HighRate": "0" }, "HotelDetails": { "HotelId": "00033859", "HotelName": "Velvett Villa", "Address1": "7/1, Gandhi Irwin Road, Opp. Egmore Railway Station, Egmore, , Egmore, CHENNAI, TAMIL NADU, India, Pin-600008", "CityDesc": "CHENNAI", "StarCategoryId": "0", "StarCategoryDesc": "No Star", "Pincode": "", "HotelPhone": "", "HotelEmail": "", "CheckIn": "15/03/2016", "CheckOut": "16/03/2016", "CheckInTime": "00:00:00", "CheckOutTime": "00:00:00", "HotelImages": "http://cdn.travelpartnerweb.com/DesiyaImages/Image/1/nxd/mat/tye/ibw/H O_TN.jpg", "Location": "Egmore", "LowRate": "1250.00", "Searchid": "100021333046", "Highrate": "1949.00", "Providerid": "4", "FacilityId": { "Facilities": [ { "Facility": "5", "FacilityName": "Internet" }, { "Facility": "8", "FacilityName": "Laundry" }, { "Facility": "9", "FacilityName": "RoomService" } ] }, "RatePlanDetails": { "Row": [ { "HotelID": "00033859", "RoomTypeID": "0000094863", "RateplanId": "0000372952", "RoomCharges": "1139", "Tax": "111", "Inclusion": "-", "PromotionName": "true", "PromotionTotal": "0", "HotelRoomTypeDesc": "Non A/C Deluxe Room" }, { "HotelID": "00033859", "RoomTypeID": "0000094864", "RateplanId": "0000372954", "RoomCharges": "1252","Tax": "238", "Inclusion": "-", "PromotionName": "true", "PromotionTotal": "0", "HotelRoomTypeDesc": "A/C Executive Room" }, { "HotelID": "00033859", "RoomTypeID": "0000094865", "RateplanId": "0000372955", "RoomCharges": "1638", "Tax": "311", "Inclusion": "-", "PromotionName": "true", "PromotionTotal": "0", "HotelRoomTypeDesc": "A/C Deluxe Room" } ] } } } } }

GET: https://www.goalltrip.com/api/hotel/hotel_detail.php?gatkey=gatkey&HotelID=140721&ProviderId=4

S.No Attribute Descriptions Required
1 gatkey gatkey (provided by Goalltrip) true
2 HotelID Hotel id of the Hotel which is provided during search. true
3 ProviderId Provider Id from the hotel search response true

    
                                           
       

Hotel Details Response

{ "HotelDetails": { "HotelDetail": { "HotelID": "1110", "HotelName": "SRM Hotel", "latitude": "12.823788568722968", "longitude": "80.04115692703249","address": "SRM Nagar - Maraimalai Nagar, Near Ford Car Factor GST Road", "city": "Chennai", "state": "Tamil Nadu", "country": "India", "ImageURL": "http:\\\\www.confirmedrooms.com\\hotelbooking\\images\\hotelimages\\11 10\\1110.jpg", "Hotelphone": "91-44-47432000,24746811,24890359", "HotelFax": "91-44-27454250,24742845", "Starlevel": "4", "Description": "chennai", "AmenityDetail": "Bar, Coffee Shop, Laundry / Dry Cleaning Service, Conference Hall, Restaurant, Travel Desk, Garden / Lawn, Gymnasium / Fitness Center, Swimming Pool, Indoor Games, Currency Exchange, Medical Services,", "GalleryImages": "http:\\\\www.confirmedrooms.com\\hotelbooking\\images\\hotelimages\\11 10\\031742.jpg, http:\\\\www.confirmedrooms.com\\hotelbooking\\images\\hotelimages\\111 0\\031752.jpg, http:\\\\www.confirmedrooms.com\\hotelbooking\\images\\hotelimages\\111 0\\031758.jpg, http:\\\\www.confirmedrooms.com\\hotelbooking\\images\\hotelimages\\111 0\\031806.JPG, http:\\\\www.confirmedrooms.com\\hotelbooking\\images\\hotelimages\\111 0\\031813.jpg, http:\\\\www.confirmedrooms.com\\hotelbooking\\images\\hotelimages\\111 0\\031820.jpg, http:\\\\www.confirmedrooms.com\\hotelbooking\\images\\hotelimages\\111 0\\031829.JPG," } } }

POST: https://www.goalltrip.com/api/hotel/hotel_booking_track.php?gatkey=gatkey

S.No Attribute Descriptions Required
1 gatkey gatkey (provided by Goalltrip) true
2 SearchId Hotel id of the Hotel which is provided during search. true
3 HotelId Provider Id from the hotel search response true
4 RoomTypeID RoomType Id from Hotel Search method true
5 RateplanId Rate Plan Id from Hotel Search method true
6 RoomInfo Room Info like 1,2,1,~4,| true
7 NoofNights No of Nights true
8 BookingAmount Booking amount in should be rounded value true
9 CheckIn Check in date in mm/dd/yyyy format true
10 CheckOut Check Out date in mm/dd/yyyy format true
11 ProviderId Provider Id from the hotel search response true
12 Fname Customer First Name true
13 Lname Customer Last Name true
14 Email Customer Email true
15 Mobile Customer Mobile No true
16 Address Customer Address true
17 City Customer City true
18 State Customer State true
19 PostalCode Customer Postal Code true
20 Country Customer Country true

    
                                           
       

Hotel Track-ID Response

{ "BookingTrack": { "TrackId": "TPD160215193144623~JCDB6WNSX", "Message": "" }
    
                                           
       

Hotel Track Important Alert

//////////////////////////////////// Response parameters: Name Description TrackId Track id for using booking confirmation method Message we have a concept to check the price variation at time of booking. This message can be view in the tag name of . This message will come only if there is any change in the price changes, otherwise it will be an empty tag. Error Code Error Description -700 FName should be 15 Characters -700 LName should be 26 Characters -701 Your Credit Limit is Insufficient -702 TrackId not generated, Already SearchId Used -703 TrackId not generated Error Response : { "Hotels": { "ErrorDetails": { "Error": { "ErrorMsg": "TrackId not generated", "ErrorCode": "-103" } } } }

POST: https://www.goalltrip.com/api/hotel/hotel_confirm_book.php?gatkey=gatkey

S.No Attribute Descriptions Required
1 gatkey gatkey (provided by Goalltrip) true
2 HotelId Hotel id of the Hotel which is provided during search. true
3 ProviderId Provider Id from the hotel search response true
4 RateplanId Pass the RatePlan Id. true
5 ClientTrackId Create unique ReferenceId from your end. This id should be unique for each booking and maximum length of 20 characters. This is used for avoid duplicate booking and error true
6 TrackId Pass Track id getting from bookingTrack method true
7 SearchId SearchId Id from the hotel search response true

    
                                           
       

Hotel Confirm Booking Response

{ "BookingInformation": { "Status": "0", "BookingID": "JCDB6WNS7" } } Status = 0 = Success
    
                                           
       

Hotel Confirm Booking Important Alert

Error Code Description -201 “Booking Confirmed , But Booking ID not generated” In this case call UpdateBookingID method for generate booking id. You must debit the amount , if you getting exception. -202 Booking Failed. In this case go to new search to book. Error Response: { "Hotels": { "ErrorDetails": { "Error": { "ErrorMsg": "Booking Failed", "ErrorCode": "-202" } } } }

POST: https://www.goalltrip.com/api/hotel/hotel_update_booking_id.php?gatkey=gatkey

S.No Attribute Descriptions Required
1 gatkey gatkey (provided by Goalltrip) true
2 UpdateBookingId Pass Track id getting from Hotel booking Track method true

    
                                           
       

Hotel Update Booking ID Response

{ "BookingInformation": { "Status": "0", "BookingID": "JCDB6WNS7" } }

POST: https://www.goalltrip.com/api/hotel/hotel_policy.php?gatkey=gatkey

S.No Attribute Descriptions Required
1 gatkey gatkey (provided by Goalltrip) true
2 HotelID Pass the Hotel Id of the hotel true
3 SearchId Pass the Search Id true
4 CheckIn Date format mm/dd/yyyy true
5 CheckOut Date format mm/dd/yyyy true
6 RatePlanID Pass the Rateplan Id true
7 RoomTypeID Pass the Room Type Id true
8 RoomInfo Room information like 1,2,0~0,| true
9 ProviderId Pass providerId of the hotel true

    
                                           
       

Hotel Terms & Conditions and Cancel Policy Response

{ "Policies": { "HotelPolicy": "If a double room is booked for the stay of a male and female guest need to carry the Government Issued photo identity proof to establish the relationship between them. If we find that the relationship is not proper than HOTEL WILL NOT PROVIDE THE ROOM AND ALSO THERE WILL NOT BE ANY REFUND.Any time check in with 24 hours check out.| ", "CancelPolicy": "Any changes / cancellation done within 24 hours of check in date will attract penalty for 1night rate + Tax.|Any changes / cancellation done before 24 hours before check in date will not attract any penalty.|No Show will be charged for full stay|", "TNC": { "#text": [ "Please read carefully the Terms and Conditions. I confirm that I have read and agreed to be bound by them ", "1.You need to carry a valid Personal Identity Proof to check in at this hotel ex: passport, driving license. Failing which the hotel may deny the room and there may be penalties levied on booking.", "2.Check in / Check out as per the hotel policy. Globally it is 1400 hrs / 1200 hrs respectively", "3.Early check in / Late check out are subject to availability and Hotel may charge for the same at the time of check out.", "4.We reserve the right to cancel or modify reservations where it appears that a customer has engaged in fraudulent or inappropriate activity or under other circumstances where it appears that the reservations contain or resulted from a mistake or error or for any force de measure reasons beyond our control (for instance – bad weather, act of god etc)." ],

POST: https://www.goalltrip.com/api/hotel/hotel_booking_info.php?gatkey=gatkey&BookingID=JCDB6YBZE

S.No Attribute Descriptions Required
1 gatkey gatkey (provided by Goalltrip) true
2 BookingID Pass BookingID Id from the Hotel Confirm Booking Response true

    
                                           
       

Hotel Booking Info Response

{ "BookingDetails": { "Hotel": { "CustomerName": "test moor", "MobileNumber": "1234567890", "Emailid": "test@test.com", "Address": "testing", "city": "Chennai", "Country": "India", "Pincode": "600032", "CheckIn": "10 Mar 2016", "CheckOut": "11 Mar 2016", "RoomInfo": "1,2,0,~0,|", "Status": "Booking Confirmed", "Currency": "INR", "HotelName": "SRM Hotel", "RoomCharges": "2735", "Tax": "618", "ImageURL": "", "address1": "SRM Nagar - Maraimalai Nagar, Near Ford Car Factor,ChennaiSouthern", "Starlevel": "4", "RoomType": "Executive Room", "RCount": "1", "Inclusions": "", "BookingId": "JCDB6WNS7", "TrackID": "TPD160216111858950", "Telephone": "91-44-47432000,24746", "Fax": "91-44-27454250,24742", "EmailAddress": "srm_rshotels@hotmail.com,srmhotel_chennai@yahoo.co.in", "NoOfNight": "1", "Date": "16 Feb 2016 11:23:06", "BookingAmount": "3353", "CheckInTime": "1010", "CheckOutTime": "1010", "TermsandCondition": { "#text": [ "Please read carefully the Terms and Conditions. I confirm that I have read and agreed to be bound by them ", "1.You need to carry a valid Personal Identity Proof to check in at this hotel ex: passport, driving license. Failing which the hotel may deny the room and there may be penalties levied on booking.", "2.Check in / Check out as per the hotel policy. Globally it is 1400 hrs / 1200 hrs respectively", ], "br": [ null, null, null, null, null, null, null ] }, "cancelpolicy": "" } }