Skip to Content
Developers
Availability

List free times

GET
/availability

The times a customer can book a service, for one day or up to 14 in a row. Leave staff_id out to get the free times of everyone who does the service. A slot is free now and may be gone a moment later: booking it answers 409 slot_taken when someone was faster.

Keys: every kind of key works here.

Authorization

apiKey
headerAuthorizationBearer wo_live_...

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

Query parameters

date*string

The first day, as the shop's own calendar has it: 2026-11-30.

Lengthlength <= 10
days?integer

How many days from date on.

Range1 <= value <= 14
Default1
service_id*string

The service to book.

Formatuuid
staff_id?string

Only this staff member's free times.

Formatuuid

Response body

The request worked.

application/json
  1. response
data*array<>
has_more*boolean

Whether another page follows this one.

next_cursor*|null
object*string
Example request
curl 'https://api.weerom.com/v1/availability?date=string&service_id=497f6eca-6276-4993-bfeb-53cbbbba6f08'
Example response
{  "data": [    {      "ends_at": "2026-11-30T09:45:00.000Z",      "object": "slot",      "service_id": "c2a41f6e-8d3b-4e97-b5a0-1f7c9e2d4a68",      "staff_id": "8e1d5b7c-3a9f-4d20-b6c4-7a2e0f9d1c53",      "starts_at": "2026-11-30T09:00:00.000Z"    }  ],  "has_more": false,  "next_cursor": null,  "object": "list"}

Details

Keys

Read keyWrite keyPublic key

Every kind of key may call it.

Sort

By starts_at, earliest first, then by staff_id. The order is fixed.

Filters

  • date is a day on the shop's own calendar, not a UTC day. With days, the list covers that day and the days after it, days in all.
  • staff_id keeps one person's times. A staff member who is inactive, unknown or does not do the service gives an empty list, not an error.

What it does

  • The times are the ones the shop's own booking form offers: its opening hours, each person's hours and breaks, bookings already made, and the lead time. Times that have passed are left out.
  • Without staff_id, the list holds the times of every active staff member who does the service. One time can show up once per person.
  • The whole list fits on one page: has_more is false and next_cursor is null. The list takes no limit, cursor or order, and sending one answers 400 invalid_request.

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
400invalid_requestdate is not a day, days is out of range, or service_id is missing.Send date as a day such as 2026-11-30 and days from 1 to 14.
404not_foundThe service does not exist or is inactive.Read GET /services and pick an active service.