Get a booking
One booking by its id.
Keys: a key that may read. A public 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.
uuidThe 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 'https://api.weerom.com/v1/bookings/497f6eca-6276-4993-bfeb-53cbbbba6f08'{ "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
Read keyWrite key
Any other kind of key answers 403 key_not_allowed.
What it does
- Time staff blocked off is not a booking. Its id answers 404.
When a field is null
cancelled_atisnulluntil the booking is cancelled.paymentisnulluntil staff note a payment for the booking.payment.methodisnullwhen no method was recorded with the payment.service.idisnullwhen the booking is not linked to a service record. The name written on the booking still shows.customer.idisnullwhen the shop erased the customer's record. The booking keeps the name, email and phone written on it.customer.emailisnullwhen the booking holds no email. Staff may book without one.customer.phoneisnullwhen the booking holds no phone number.
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. |
Make a booking POST
Books a free time for a customer and answers with the booking. The shop's rules apply as on its own booking form: opening hours, how far ahead a booking may be made, a paused form, a blocked customer. The customer gets the shop's confirmation mail and staff get their usual notice. A public key books as a visitor, with a visitor's limits per address and per person, and may not send `as`. A write key may send `as: staff` to book like staff typing a walk-in into the agenda, which skips the lead time and the paused form. Send an `Idempotency-Key` so a retry after a timeout cannot book twice. **Keys:** a public key, or a key that may read and change. A key that may only read gets 403.
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.