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

# Customers overview

> Customer profile, cards on file, bookings, and account settings

Use the Customers API for the signed-in shopper: profile, saved cards, their
appointments, and account settings.

## What you do first

1. [Get my profile](/api-reference/customers/get-my-profile) after sign-in, and
   [update my profile](/api-reference/customers/update-my-profile) when contact
   details change.
2. [List my payment methods](/api-reference/customers/list-my-payment-methods)
   and set a default card before booking holds that need a card on file.
3. [List my appointments](/api-reference/customers/list-my-appointments) or
   [get a specific appointment](/api-reference/customers/get-a-specific-appointment-for-me)
   for the client timeline.
4. [Get my settings](/api-reference/customers/get-my-settings) for notification
   preferences.

## States that matter

| Surface        | What it means for the next call                                               |
| -------------- | ----------------------------------------------------------------------------- |
| Default card   | Used for booking authorization holds on on-platform payments                  |
| Contact change | Verify the current contact, then the new destination, before it sticks        |
| Account delete | Soft delete; appointments stay for the barber with personal fields anonymized |

## 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 include payment method setup
failures, contact challenges that expired, and trying to unset the only default
card.

## Related paths

* Sign-in lives under [Authentication](/api-reference/Authentication/overview).
* Booking and pays live under [Appointments](/api-reference/Appointments/overview).