Skip to Content
Developers
Bookings

Get a booking

GET
/bookings/{id}

One booking by its id.

Keys: a key that may read. A public key gets 403.

Authorization

apiKey
headerAuthorizationBearer wo_live_...

A key from the shop's admin. Secret keys start with wo_live_, public keys with wo_pub_.

Path parameters

id*string

The object's id.

Formatuuid

Response body

The request worked.

application/json
  1. response

An appointment.

cancel_reason*string

Empty unless cancelled.

cancelled_at*|null
code*string

The short code the customer sees.

comments*string

What the customer wrote when booking.

created_at*string

When the booking was made.

Formatdate-time
currency*string

ISO 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*integer

Percent off the list price. 0 without a deal.

ends_at*string

When the appointment ends.

Formatdate-time
id*string

The booking's id.

Formatuuid
list_price_cents*integer

The price before any deal.

locale*string

The language the customer's mail about it goes out in.

minutes*integer

How long the appointment takes.

object*string
payment*|null
price_cents*integer

The price the customer was promised, VAT included.

service*
source*string

web for an online booking, admin for one staff typed in.

Value in"web""admin"
staff_id*string

Who the booking is with.

Formatuuid
starts_at*string

When the appointment starts.

Formatdate-time
status*string

confirmed is booked and still to come or not yet closed by staff. completed is done. no_show means the customer did not come.

Value in"confirmed""completed""cancelled""no_show"
updated_at*string

When the booking last changed.

Formatdate-time
Example request
curl 'https://api.weerom.com/v1/bookings/497f6eca-6276-4993-bfeb-53cbbbba6f08'
Example response
{  "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_at is null until the booking is cancelled.
  • payment is null until staff note a payment for the booking.
  • payment.method is null when no method was recorded with the payment.
  • service.id is null when the booking is not linked to a service record. The name written on the booking still shows.
  • customer.id is null when the shop erased the customer's record. The booking keeps the name, email and phone written on it.
  • customer.email is null when the booking holds no email. Staff may book without one.
  • customer.phone is null when 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.

StatuscodeWhenWhat to do
404not_foundNo 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.