Skip to main content
POST
/
api
/
public
/
v2
/
bookings
/
{bookingId}
/
cancel
cURL
curl -X POST \
  "https://www.headout.com/api/public/v2/bookings/12345/cancel/" \
  --header 'Headout-Auth: <YOUR_API_KEY>' \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "CHANGE_OF_TRAVEL_PLANS",
    "comment": "Customer cannot attend"
  }'

{
  "success": true,
  "message": "Cancellation request submitted successfully"
}

Authorizations

​
Headout-Auth
string
header
required

Path Parameters

​
bookingId
string
required

Booking identifier owned by the calling partner.

Body

application/json
​
reason
enum<string>
required

Cancellation reason.

Available options:
TICKETS_NOT_RECEIVED,
CHANGE_OF_TRAVEL_PLANS,
MODIFY_EXISTING_RESERVATION,
FOUND_CHEAPER_OPTION_ELSEWHERE,
OTHER
Example:

"CHANGE_OF_TRAVEL_PLANS"

​
comment
string | null

Optional free-text comment

Response

Acknowledgement of cancellation submission or business-rule failure

​
success
boolean

Indicates whether the request was accepted

Example:

true

​
message
string

Human-readable message describing the outcome

Example:

"Cancellation request submitted successfully"