Cancellation Request

Method URL
DELETE api/v3/hotels/bookings/
  • <bref> refers to the ‘GRN booking_reference’ returned in the booking response.

Payload

Attribute Type Required Description
comments string OPTIONAL Cancellation comments
reason integer OPTIONAL Possible values:
1: Found lower price on the Internet
2: Found lower price through a local agent
3: Did not like cancellation terms
4: Did not like payment terms
5: Will book a different hotel through your site
6: Will book with hotel directly
7: Decided on a different hotel not offered by your site
8: Booking was not confirmed quickly enough
9: Concerns about reliability / trustworthiness
10: Concerns about safety at the hotel's location
11: Forced to cancel or postpone trip
12: Natural Disaster
13: Others

Sample Cancellation Payload

{
    "comments":"cancellation comments",
    "reason": 5
}

Cancellation Response

Response

Attribute Type Description
cancellation_reference string Unique cancellation code
cancellation_comments string Cancellation comments
status string Cancellation status will be one of the following:
1. confirmed
2. failed
3. rejected
4. pending
cancellation_charges object When available, cancellation charges are returned as shown below: { “amount”: 346.42, “currency”: “EUR” }
booking_id string Booking ID
booking_reference string Booking reference
booking_price object Booking price as shown below:
{
“amount”: 346.42,
“currency”: “EUR”
}

Error Codes

HTTP Status Code Error Code Description
200 2002 Invalid Booking Reference
200 2003 Booking has already been cancelled
200 2006 Need confirmation from supplier
200 5120 Request timed out at supplier’s end
404 5121 Booking not found
200 5142 Changes cannot be done to this booking item
200 5143 Past booking items cannot be cancelled
200 5151 This Booking cannot be cancelled from Supplier’s end.
Supplier does not support cancellation from API if the
cancel_by_date has crossed or the booking is under_cancellation
401 1110 Request Blocked. Multiple Requests Received. Please try after sometime.

Sample Cancellation Response

{
    "status": "confirmed",
    "cancellation_reference": "i5qaijh2qujw7k4km4sueop63a",
    "cancellation_comments": "cancellation comments",
    "cancellation_charges": {
        "currency": "INR",
        "amount": 0
    },
    "booking_reference": "ftjtcfl67mmlgii",
    "booking_price": {
        "currency": "INR",
        "amount": 16966.59
    },
    "booking_id": "GRN-201611-000566"
}