Skip to main content
You can call the Guile API without an account. An anonymous token covers the operations that don’t need a signed-in person, so you can try a real request right now. The base URL is https://api.guile.app.
1

Get a token

You get back two tokens. Both are strings.
Export the access token for the next call:
Send authToken on your calls. When it expires, exchange refreshToken for a fresh pair with POST /auth/exchangeRefreshToken instead of asking the person to sign in again. The authentication overview walks through the full sign-in flow.
2

Make an authenticated call

Put the token in an Authorization header:
That returns the service categories a shop can offer, like haircuts or beard trims. Every other read works the same way.

​
When a call fails

Failures come back as a problem document, not a bare status code. The type field is a link to a page that says what to do:
Open the link and you get the cause, the fix, and whether retrying is safe. The error reference lists every one.

​
Next

Sign a person in

Move from an anonymous token to a real customer or barber session.

Book an appointment

Hold a time with a barber.

Charge safely

Use idempotency keys and replay the same logical write when the outcome is unknown.

Download the definition

The OpenAPI file and Postman collection.