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",
"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:
- Call
BookingGet first.
- Read
cancellationPolicies and compute the applicable penalty for today’s date.
- Then call DELETE.
1. BookingGet (read cancellationPolicies)
2. Compute penalty for current date
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.