> ## Documentation Index
> Fetch the complete documentation index at: https://docs.guile.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Barbers overview

> Read and update barber profiles, schedules, settings, and public reviews

Use the Barbers API when you need a barber's public booking surface or the
authenticated barber's own profile, hours, and settings.

## What you do first

1. [Get a barber's profile](/api-reference/barbers/get-a-barber-s-profile) for the
   public name, photo, and booking slug shoppers see.
2. [Get a barber's availability](/api-reference/barbers/get-a-barber-s-availability)
   or [booking hours](/api-reference/barbers/get-a-barber-s-booking-hours) before
   you offer times.
3. [Update a barber profile](/api-reference/barbers/update-a-barber-profile) or
   settings when the authenticated barber changes how they appear or book.
4. [List a barber's public reviews](/api-reference/barbers/list-a-barber-s-public-reviews)
   for social proof; approve or reject pending reviews from the same domain.

## States that matter

| Surface              | What it means for the next call                                     |
| -------------------- | ------------------------------------------------------------------- |
| Booking slug         | Must be unique; check availability before you claim one             |
| Schedule vs override | Weekly hours set the default; overrides cover time off and holidays |
| Review pending       | Hidden from customers until the barber approves                     |

## When a call fails

Failures come back as problem documents. Open the `type` link for the cause,
the fix, and whether retrying is safe. Common ones here include a missing
barber, a taken booking slug, and schedule bounds that do not form a pair.

## Related paths

* Bookable services live under [Services](/api-reference/Services/overview).
* Visits live under [Appointments](/api-reference/Appointments/overview).
* Client roster and groups live under [Clients](/api-reference/Clients/overview).