Skip to main content
Update a booking’s details, payment status, or cancel it in the sandbox environment.

​
Path Parameters

​
booking_id
number
required
The unique identifier of the booking to update

​
Request Body

​
booking_status
string
Updated booking status (confirmed, pending, cancelled, completed)
​
payment_schedule
array
Updated payment schedule with milestone statuses
​
cancellation_reason
string
Reason for cancellation (required if status is “cancelled”)
​
modification_notes
string
Notes about the modification

​
Response Format

{
  "booking_id": 5001,
  "event_id": 789,
  "booking_status": "confirmed",
  "amount_paid": 75000,
  "amount_remaining": 50000,
  "payment_schedule": [
    {
      "milestone": "Deposit",
      "amount": 25000,
      "status": "paid"
    },
    {
      "milestone": "Second Payment",
      "amount": 50000,
      "status": "paid",
      "paid_date": "2027-01-15"
    },
    {
      "milestone": "Final Payment",
      "amount": 50000,
      "status": "pending"
    }
  ],
  "updated_at": "2025-11-22T10:00:00Z"
}

​
Example Request - Update Payment

{
  "payment_schedule": [
    {
      "milestone": "Second Payment",
      "status": "paid",
      "paid_date": "2027-01-15"
    }
  ],
  "modification_notes": "Second payment received"
}

​
Example Request - Cancel Booking

{
  "booking_status": "cancelled",
  "cancellation_reason": "Event postponed indefinitely",
  "modification_notes": "Client requested cancellation, deposit refunded"
}

​
Notes

  • Cancellations before the deadline may allow deposit refunds
  • Payment schedule updates automatically recalculate amount_remaining
  • Cancelled bookings cannot be reactivated (create new booking instead)