Skip to content

BookingDelete (Cancel)

DELETE {base_url}/1.0/bookings/{bookingId}

Cancel a previously-confirmed booking.

Header Value
Authorization Bearer <access_token>
Accept application/json
Param Type Description
bookingId int Booking ID to cancel
{
"cancellationPolicies": [
{
"startDate": "2027-05-12T00:00:00Z",
"endDate": "2027-05-15T23:59:59Z",
"amount": 116.00,
"currency": "USD"
}
],
"status": "CANCELLED",
"eventId": "81f900f8-5e24-43bb-b6d6-946ef8beac1f"
}

A successful BookingDelete response may omit the error property; do not require it.

Status Meaning
CANCELLED Cancellation succeeded
CONFIRMED Cancellation failed; booking still active
Code HTTP Message Cause What to do
1203 400 Your reservation is currently being created. Please wait a moment before accessing it. Observed when cancelling seconds after creating the booking, while it was still in CREATED status Wait at least 90 seconds after creating the booking, then retry the DELETE
3003 500 Cannot get a valid response from the cancellation service Supplier/internal failure Contact PriceTravel with the request, the response, and the eventId
3005 500 Cancellation in progress but couldn’t be confirmed (timeout) The cancellation timed out and could not be confirmed Retry in a few minutes; verify with BookingGet

The DELETE response returns the booking’s cancellationPolicies, but no field with the amount actually charged. To know what will be charged:

  1. Call BookingGet first.
  2. Read cancellationPolicies and compute the applicable penalty for today’s date.
  3. Then call DELETE.
1. BookingGet (read cancellationPolicies)
2. Compute penalty for current date
3. Confirm with user
4. Wait until ≥90 seconds since booking creation (if recent)
5. DELETE /bookings/{bookingId}
6. Verify status === "CANCELLED" in response
7. If response is timeout/3005, retry BookingGet after 1-2 min
  • Cancelling a booking that is already CANCELLED returns success without further charges.
  • Cancelling a booking inside the non-refundable window means the full rate is charged but the booking status still becomes CANCELLED.
  • Some suppliers do not support cancellation at all — error 1202 may indicate this.