Cancel a booking
Cancels a booking and frees its time. The customer gets the shop's cancellation mail. As customer the shop's cut-off applies: past it the answer is 409 too_late. A booking that is already cancelled or finished answers 409 wrong_state.
Keys: a key that may read and change. Any other key gets 403.
apiKeyAuthorizationBearer wo_live_...A key from the shop's admin. Secret keys start with wo_live_, public keys with wo_pub_.
id*stringThe object's id.
uuidIdempotency-Key?stringAny unique text, such as a UUID. A retry with the same key and the same request gets the first answer back and changes nothing twice. Kept for 24 hours.
length <= 255application/json- body
as?stringcustomer keeps the shop's rules, such as how late a booking may still be cancelled. staff acts as the shop and skips them.
"customer""customer""staff"reason?stringWhy, for the shop's own record.
length <= 300The request worked.
application/json- response
An appointment.
cancel_reason*stringEmpty unless cancelled.
cancelled_at*|nullcode*stringThe short code the customer sees.
comments*stringWhat the customer wrote when booking.
created_at*stringWhen the booking was made.
date-timecurrency*stringISO 4217 code of every amount on this object.
customer*Who the booking is for, as written on the booking when it was made.
discount_percent*integerPercent off the list price. 0 without a deal.
ends_at*stringWhen the appointment ends.
date-timeid*stringThe booking's id.
uuidlist_price_cents*integerThe price before any deal.
locale*stringThe language the customer's mail about it goes out in.
minutes*integerHow long the appointment takes.
object*stringpayment*|nullprice_cents*integerThe price the customer was promised, VAT included.
service*source*stringweb for an online booking, admin for one staff typed in.
"web""admin"staff_id*stringWho the booking is with.
uuidstarts_at*stringWhen the appointment starts.
date-timestatus*stringconfirmed is booked and still to come or not yet closed by staff. completed is done. no_show means the customer did not come.
"confirmed""completed""cancelled""no_show"updated_at*stringWhen the booking last changed.
date-timecurl -X POST 'https://api.weerom.com/v1/bookings/497f6eca-6276-4993-bfeb-53cbbbba6f08/cancel' \ -H 'Content-Type: application/json' \ -d '{ "reason": "Asked to come next week"}'{ "cancel_reason": "", "cancelled_at": null, "code": "UEAMEFC9", "comments": "", "created_at": "2026-11-18T14:02:11.000Z", "currency": "EUR", "customer": { "email": "[email protected]", "id": "5f0c9d3a-7b2e-4c61-8a4d-9e1f3b6c2d75", "name": "Lotte Peeters", "phone": "+32470123456" }, "discount_percent": 0, "ends_at": "2026-11-21T10:15:00.000Z", "id": "0b6f2a4e-5d1c-4f7a-9a3e-2c8d1e6f4b90", "list_price_cents": 4000, "locale": "nl", "minutes": 45, "object": "booking", "payment": { "amount_cents": 4000, "method": "bancontact", "paid_at": "2026-11-21T10:12:40.000Z", "tip_cents": 200 }, "price_cents": 4000, "service": { "id": "c2a41f6e-8d3b-4e97-b5a0-1f7c9e2d4a68", "name": "Knippen en baard" }, "source": "web", "staff_id": "8e1d5b7c-3a9f-4d20-b6c4-7a2e0f9d1c53", "starts_at": "2026-11-21T09:30:00.000Z", "status": "completed", "updated_at": "2026-11-21T10:12:40.000Z"}Details
Keys
Write key
Any other kind of key answers 403 key_not_allowed.
What it does
- The booking's
statusbecomescancelled,cancelled_atis set and the time is free at once. - The customer gets the shop's cancellation mail when the booking has an email. As
customer, staff also get their usual notice. Asstaff, they do not. reasonis stored ascancel_reason, trimmed.
Webhooks
A call that works sends booking.cancelled to the shop's webhook addresses that listen for it. See Webhooks.
Errors
Besides 401 for a missing, unknown or removed key, 403 plan_required, 429 rate_limited and 500 internal_error, which every endpoint can answer. Errors has all of them.
| Status | code | When | What to do |
|---|---|---|---|
| 404 | not_found | No object has this id, or the id is not a UUID. | Check the id. Ids are UUIDs from a list or from an earlier answer. |
| 409 | wrong_state | The booking's status is not confirmed: it is cancelled, completed or a no-show. | Read the booking with GET /bookings/{id} and show its status. A cancelled booking stays cancelled. |
| 409 | too_late | As customer, the start is closer than the shop's cut-off for cancelling online. | Tell the customer to call the shop, or send "as": "staff" to act as the shop. |
| 409 | idempotency_mismatch | The Idempotency-Key was used before for a request with another method, path or body. | Make a new Idempotency-Key for a new request. |
| 409 | request_in_progress | The first request with this Idempotency-Key still runs. | Wait a second and send the same request with the same key again. |
Get a booking GET
One booking by its id. **Keys:** a key that may read. A public key gets 403.
Move a booking POST
Moves a booking to another time, and to another staff member when `staff_id` is sent. The customer gets the shop's mail about the move. As `customer` the shop's cut-off for moving applies. **Keys:** a key that may read and change. Any other key gets 403.