Skip to Content
Developers
Customers

Get a customer

GET
/customers/{id}

One customer by their 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

A person who booked at the shop.

blocked*boolean

The shop no longer takes online bookings from them.

created_at*string

When the shop first saw this customer.

Formatdate-time
email*|null
has_account*boolean

Whether they sign in on the shop's site.

id*string

The customer's id.

Formatuuid
locale*string

The language their mail goes out in.

name*string

As the customer or staff typed it.

no_show_count*integer

How many bookings staff marked as not shown up.

object*string
phone*string

E.164.

postal_code*|null
updated_at*string

When the record last changed.

Formatdate-time
Example request
curl 'https://api.weerom.com/v1/customers/497f6eca-6276-4993-bfeb-53cbbbba6f08'
Example response
{  "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

  • email is null when the shop has no email for the customer.
  • postal_code is null when 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.

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.