Contact Cleartrip's business development team, Sandeep Sanil (email@example.com) of the intent to integrate APIs along with your company information.
user-idto firstname.lastname@example.org. An API key and the Cleartrip staging API URLs will be emailed.
user-idto email@example.com. An API key and the cleartrip production API URLs will be provided.
A deposit account ID is made available 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 are 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 the trips, trip details, deposit account details etc using the dashboard. The dashboard is provided, when you login into your account on Cleartrip.
You can search for trips based on customer details and trip-references to help service your customer.
You can also create and download standard MIS reports of your transactions from the dashboard.
If you are in the integration phase, you can expect an email/resolution within 24 hours.
If you are in production phase, you can expect an email/resolution within 4 hours.
The list of input cities can be found at http://www.cleartrip.com/places/hotels/city_list.txt
You can find the list of hotels 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 the detailed information about each hotel as specified in the API documentation.
The copyright information for each of the hotels is available in the hotel xml.
Note: If you are using this information, you will need to credit the copyright owners.
No. The volume makes it impractical. You can display the images of Cleartrip's website and you need to link these on your own.
The image links are available in the hotel-info xml and needs to be prefixed by the following links, depending on the Cleartrip environment that 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 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> is 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.
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.
Log on to http://www.cleartrip.com with your registered user-id and password and access the “My account” link. This lists 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://apistaging.com/hotels/1.0/trips/D0805080031 or https://api.cleartrip.com/hotels/1.0/trips/D0805080031.
To retrieve the same details using your own transaction id, you can use http://apistaging.com/hotels/1.0/trips/ext/XXXXXXX or https://api.cleartrip.com/hotels/1.0/trips/ext/XXXXXXX, where XXXXXXX is your transaction id.
Check the following:
If the book URL is not accessible and if you cannot ping the environment, then contact your system administrator.
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 – The API key (for the appropriate environment) is 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,
then check for parameters, and refer to the API documentation.
If the HTTP response code from the book call is a 500 series check,
then check, whether the parameters gathered from a search response are obtained in the last 28 minutes.
Note: A room not being available is a Valid 500 response. It means that the room is no longer available.
If you have verified all of the above and the response XML along with the 500 series response that displays a “SYSTEM” error, then send the complete search response, book request and book response XMLs to email@example.com.
Note: All the three XMLs need to be attached in order, to get the support.
The API channel is not selected for Hotel rates and so, we do not get any search results.
It depends on the availability of data in cache based on similar search criteria. We usually store information in cache for a short span since availability keeps changing.
We gather data from multiple suppliers in order to provide a wider range and more comprehensive set of hotels to our customers. The APIs however, will return data within 45 seconds.
We recommend to calculate the total cost of the stay based on the exact amounts returned in the search response and round the price to the final amount.
Note: The Cleartrip API system will reject all bookings, where the API input booking amount is less than 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.