Get a customer
One customer by their 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
A person who booked at the shop.
blocked*booleanThe shop no longer takes online bookings from them.
created_at*stringWhen the shop first saw this customer.
date-timeemail*|nullhas_account*booleanWhether they sign in on the shop's site.
id*stringThe customer's id.
uuidlocale*stringThe language their mail goes out in.
name*stringAs the customer or staff typed it.
no_show_count*integerHow many bookings staff marked as not shown up.
object*stringphone*stringE.164.
postal_code*|nullupdated_at*stringWhen the record last changed.
date-timecurl 'https://api.weerom.com/v1/customers/497f6eca-6276-4993-bfeb-53cbbbba6f08'{ "blocked": false, "created_at": "2026-04-11T09:05:22.000Z", "email": "[email protected]", "has_account": true, "id": "5f0c9d3a-7b2e-4c61-8a4d-9e1f3b6c2d75", "locale": "nl", "name": "Lotte Peeters", "no_show_count": 0, "object": "customer", "phone": "+32470123456", "postal_code": "9000", "updated_at": "2026-11-18T14:02:11.000Z"}Details
Keys
Read keyWrite key
Any other kind of key answers 403 key_not_allowed.
When a field is null
emailisnullwhen the shop has no email for the customer.postal_codeisnullwhen the customer never gave one.
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. |
List customers GET
Customers sorted by when the shop first saw them. Filter by `email` or `phone` to look one up, or by `updated_after` to fetch what changed since your last sync. **Keys:** a key that may read. A public key gets 403.
Change a customer PATCH
Changes a customer's name or blocks them. Send only the fields to change. There is no endpoint that makes a customer: making a booking makes its customer. **Keys:** a key that may read and change. Any other key gets 403.