> ## 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.

# Guile API

> Book appointments, take payments, and cash out earnings through one API

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

<Columns cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get a token and make your first call in two steps.
  </Card>

  <Card title="API reference" icon="terminal" href="/api-reference/introduction">
    Every operation, grouped by domain.
  </Card>

  <Card title="Errors" icon="triangle-exclamation" href="/api-reference/problems">
    What each failure means and what to do next.
  </Card>

  <Card title="Downloads" icon="download" href="/api-reference/artifacts">
    The OpenAPI definition and Postman collection.
  </Card>
</Columns>

## Pick a domain by job

| Job                              | Start here                                                        |
| -------------------------------- | ----------------------------------------------------------------- |
| Sign someone in                  | [Authentication overview](/api-reference/Authentication/overview) |
| Book a visit                     | [Appointments overview](/api-reference/Appointments/overview)     |
| Take a card in person            | [Payments overview](/api-reference/Payments/overview)             |
| Cash out to a bank or debit card | [Payouts overview](/api-reference/Payouts/overview)               |
| Quote fees before a total        | [Fees overview](/api-reference/Fees/overview)                     |
| Return captured money            | [Refunds overview](/api-reference/Refunds/overview)               |

## 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](/api-reference/idempotency). 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.