Move a booking
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.
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"staff_id?stringMove it to this staff member as well.
uuidstarts_at*stringThe new start, a starts_at from GET /availability.
date-timeThe 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/reschedule' \ -H 'Content-Type: application/json' \ -d '{ "starts_at": "2026-12-01T13:30:00.000Z"}'{ "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 keeps its
id,codeand service.starts_atandends_atmove, andstaff_idchanges when you send it. - The customer gets the shop's mail about the move when the booking has an email.
Webhooks
A call that works sends booking.updated 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 |
|---|---|---|---|
| 400 | invalid_request | A field is malformed, or the new staff member does not do the booking's service. | Pick a staff member whose service_ids hold the booking's service. |
| 404 | not_found | No booking has this id, or no staff member has the staff_id you sent. | Check the booking id and the staff_id. |
| 409 | wrong_state | The booking's status is not confirmed, or it is not linked to a service. | Read the booking with GET /bookings/{id} and show its status. |
| 409 | too_late | As customer, the start is closer than the shop's cut-off for moving online. | Tell the customer to call the shop, or send "as": "staff" to act as the shop. |
| 409 | slot_taken | The new time is not one the shop offers, or someone booked it first. | Ask GET /availability for the booking's service again and pick another time. |
| 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. |
Cancel a booking POST
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.
List payments GET
Bookings a customer paid for, sorted by when staff noted the payment. This is the list an invoicing tool reads: each one carries the amount, the VAT inside it and who paid. **Keys:** a key that may read. A public key gets 403.