v1.0 React + Vite MIT

Booking API examples

The same guest booking flow — location, barber, services, time, confirmation — built twice, open source, calling the real API as you read this.

The Booking API is one of the client-facing tools of a Barberly account, alongside the shop’s app, website and booking widgets. It books the way a client books: the catalog, the availability and the booking rules you meet here are the ones the shop configured for its own booking page. These pages run against a demo shop with a public key, so everything is live and every booking is real. Book as often as you like — the data is disposable.

Examples

01 · any order

Appointment hub

One card with four editable fields. The guest fills them in any order and the summary validates the whole thing at the end. Suits shops whose clients arrive knowing what they want.

Open the demo → 02 · guided

Guided wizard

Five gated steps with a progress bar and a single forward action. One decision per screen, nothing to skip. Suits shops that want a funnel with no dead ends.

Open the demo →

What they call

Operations

GET /v1/locations — bookable locations

POST /v1/locations/{id}/team-members — who can take it

POST /v1/locations/{id}/services — services and add-ons

POST /v1/locations/{id}/availability/{year}/{month} — days and slots

POST /v1/bookings — create

PUT /v1/bookings/{id} — reschedule or change

POST /v1/bookings/{id}/cancel — cancel