Skip to main content
POST
/
bookings
/
{id}
/
cancel
Cancel Booking
curl --request POST \
  --url https://api.example.com/bookings/{id}/cancel \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "<string>"
}
'

​
Request

​
reason
string
Optional cancellation reason.
curl -X POST https://api.midasprotocol.org/bookings/booking-uuid/cancel \
  -H "Authorization: Bearer pp_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "No longer needed" }'

​
Response

{
  "id": "uuid", "status": "CANCELLED",
  "refundAmount": "25.00", "refundPercent": 100,
  "currency": "USDC", "reason": "No longer needed",
  "cancelledAt": "2026-01-01T00:00:00.000Z"
}
Refund percentage depends on the service’s cancellation policy and timing.