Skip to main content
Guile runs booking and payments for barbershops. One API covers the whole job: find a barber, book a time, take payment, and cash out earnings. Everything on this site describes the public API. Our own apps are built on it, so what they can do, you can do.

​
Start here

Quickstart

Get a token and make your first call in two steps.

API reference

Every operation, grouped by domain.

Errors

What each failure means and what to do next.

Downloads

The OpenAPI definition and Postman collection.

​
Pick a domain by job

​
How the API is organized

Appointments, payments, payouts, and refunds are the money paths. Barbers, shops, services, and clients describe who and what a booking involves. Reads and writes both use bearer tokens. Writes that move money take an idempotency key. When a timeout leaves the outcome unknown, replay the same logical write with the same key. Do not invent a new key after an ambiguous timeout.