Inform Cleartrip's BD team of the intent to integrate along with your company information.
Contacts for the above are Sandeep Sanil (firstname.lastname@example.org) and Tarique Khatri (email@example.com)
user-idto firstname.lastname@example.org. An API key and Cleartrip staging API URLs will be emailed back.
user-idto email@example.com. API key and Cleartrip production API URLs will be given.
A deposit account ID will be made available to you upon expressing intent to use the deposit account payment option.
You will have to make a cheque payment to Cleartrip (contact firstname.lastname@example.org for details) against your deposit account.
You will be allowed to transact on the deposit account 24 hours AFTER the money has been credited to Cleartrip's account.
Cleartrip provides a dashboard for this purpose. You can view trips that have been booked, trip details, deposit account details etc using this dashboard. You will be presented with this dashboard automatically when you login into your account on Cleartrip.
You can search for trips based on customer details, trip-references etc to help service your customer.
You can also create and download standard MIS reports of your transactions from the same dashboard.
If you are in the integration phase and using Cleartrip staging environment, you can expect an email and or resolution within 24 hours.
If you are in production and using Cleartrip production environment, then you can expect email/resolution within 4 hours. (24x7)
You can find list of input cities at http://www.cleartrip.com/places/hotels/city_list.txt
You can find list of hotels that are available at http://www.cleartrip.com/places/hotels/hotel_directory.txt
Based on the hotel-ids found in the hotel directory, you can use the hotel-info API to download detailed information about each hotel as detailed in the API documentation.
The copyright information on each of the hotels is available in the hotel xml.
Please note: If you are using this information and displaying it, you will need to credit the copyright owners.
No. The volume makes it impractical. You can display the images off of Cleartrip's website and just link to these on your own.
The image links are available in the hotel-info xml and needs to be prefixed by the following depending on the Cleartrip environment you are using:
Please check the following:
for staging -
for production -
Cleartrip aggregates inventory from various suppliers. Cleartrip does not allow re-distribution of inventory from some suppliers. But these are available for B2C customers on our site.
Further, our staging environment usually has far fewer inventory than our production environment.
<room-rates> element will contain one or more
Each of these
<room-rate> elements correspond to a particular
<room-type> and the pricing
<rate-breakdown> associated with that
Each of the
<common-rate> elements within a
<rate-breakdown> element represents pricing of that room-type on a per day basis irrespective of the number of rooms requested.
In other words, if two rooms were requested, the pricing within a given
<common-rate> holds good for the day specified in the
<date> element for both the rooms and if one room was requested, the pricing within the given
<common-rate> holds good for the day specified in the
<date> element for the one room that was requested.
In the book call, pass in your transaction ID in the
You can retrieve the itinerary details using the same transaction id – Refer to question 17 above.
Log on to http://www.cleartrip.com with your registered user-id and password and access the “My account” link. This will list all the trips.
A booking-id is obtained as part of the book response. You can use the retrieve itinerary call with this booking-id to obtain details of a given trip.
For example, if “D0805080031” is obtained as the booking id, use http://api.staging.com/hotels/1.0/trips/D0805080031 or https://api.cleartrip.com/hotels/1.0/trips/D0805080031 as appropriate.
To retrieve the same details using your own transaction id (assuming you have passed it in the book call – refer to question 12), you can use http://api.staging.com/hotels/1.0/trips/ext/XXXXXXX or https://api.cleartrip.com/hotels/1.0/trips/ext/XXXXXXX as appropriate where XXXXXXX is your transaction id.
Please check the following
Is the book URL accessibile? Can you ping the environment? If not contact your system administrator first.
Basic authentication: Cleartrip staging environment is protected by basic authentication. You will need to ensure that your API calls are using the authentication. There is an example of how to do this in Java/Ruby in the API doc code samples.
API Key – Is the API key (for the appropriate environment) being sent as part of the HTTP header? Refer to the API doc code samples.
If the HTTP response code from the book call is a 400 series check:
Are the parameters correct? Please refer to the API documentation for details.
If the HTTP response code from the book call is a 500 series check:
Are the parameters gathered from a search response obtained in the last 28 minutes?
Please Note: A room not being available is a Valid 500 response. It means that the room is no longer availabile.
If you have verified all of the above and the response XML along with the 500 series response displays a “SYSTEM” error, please send the complete search response, book request and book response XMLs to email@example.com.
Please Note: All the three XMLs need to be attached in order for support to get back to you.
See question 18 above.
Depends on the availability of data in cache based on similar search criteria. We usually store information in cache for a short while since availability keeps changing.
We gather data from multiple suppliers in order to provide a wider range and more comprehensice set of hotels to our customers. The APIs however, will return data within 45 seconds for the most part.
We recommend that you calculate the total cost of the stay based on the exact amounts returned in the search response and round up/down the final amount.
Note that the Cleartrip API system will reject all bookings where the API input booking amount is less the Cleartrip calculated booking amount by more than 1 rupee. The Cleartrip API system will accept bookings where the API input booking amount is greater than the Cleartrip calculated booking amount.