# Cliento for developers

> Cliento is a complete booking system with point of sale (POS) for appointment businesses such as salons, clinics and workshops. This site is its developer documentation: the Cliento API, a REST API with API keys for server-to-server integrations, and online booking through the booking widget, the hosted booking page and the Widget API.

Every documentation page is also published as Markdown, at its address followed by `.md`; the widget builder is an interactive page and has none. All of them in one file: https://developers.cliento.com/llms-full.txt

## Cliento API

- [Cliento API overview](https://developers.cliento.com/docs/api.md): The Cliento API gives your own systems server-to-server access to an organisation's data in Cliento. It is a REST API with JSON bodies, authenticated with an...
- [Cliento API reference](https://developers.cliento.com/docs/api/reference.md): Reference for the Cliento API: authentication, identifiers, errors, versioning and what else applies to every call.
- [Cliento API reference: Locations](https://developers.cliento.com/docs/api/reference/locations.md): Reference for the Cliento API, locations: every endpoint with its parameters and responses.
- [Cliento API reference: Staff](https://developers.cliento.com/docs/api/reference/staff.md): Reference for the Cliento API, staff: staff and staff hours.
- [Cliento API reference: Customers](https://developers.cliento.com/docs/api/reference/customers.md): Reference for the Cliento API, customers: persons, recipes, companies, vehicles, customers and customer log.
- [Cliento API reference: Booking](https://developers.cliento.com/docs/api/reference/booking.md): Reference for the Cliento API, booking: resources, services, schedules, availability and bookings.
- [Cliento API reference: Point of sale](https://developers.cliento.com/docs/api/reference/point-of-sale.md): Reference for the Cliento API, point of sale: merchants, gift cards, points of sale, sales, receipts, payments and invoices.
- [Cliento API reference: Products and stock](https://developers.cliento.com/docs/api/reference/products-and-stock.md): Reference for the Cliento API, products and stock: products, stock movements and stocktakes.
- [Cliento API reference: Colour bar](https://developers.cliento.com/docs/api/reference/colour-bar.md): Reference for the Cliento API, colour bar: colour bar ranges, colour bar items and colour bar mixes.
- [Cliento API reference: Marketing](https://developers.cliento.com/docs/api/reference/marketing.md): Reference for the Cliento API, marketing: campaigns and reviews.
- [Cliento API reference: Reports](https://developers.cliento.com/docs/api/reference/reports.md): Reference for the Cliento API, reports: every endpoint with its parameters and responses.
- [OpenAPI document](https://developers.cliento.com/openapi/cliento-api-v1.json): The Cliento API as OpenAPI 3.1, in JSON.

## Documentation

- [Getting started](https://developers.cliento.com/docs.md): Cliento is a complete booking system with point of sale (POS). As a developer you can build on it in two ways: connect your own systems to the data in Client...
- [The Cliento application](https://developers.cliento.com/docs/cliento.md): Most people who use Cliento never see an API. Staff work in the Cliento application.
- [What you can build](https://developers.cliento.com/docs/use-cases.md): The Cliento API connects Cliento to the other systems a business runs on. These are the integrations businesses ask for most.
- [Need help?](https://developers.cliento.com/docs/help.md): Use the chat button at the bottom right of any page. It reaches Cliento's support team, the same one that answers in Cliento itself. If you are signed in her...

## Online booking

- [Online booking overview](https://developers.cliento.com/docs/online-booking.md): There are three ways to let your customers book online with Cliento. They share the same services, prices and calendar, so a booking made through any of them...
- [Hosted booking page](https://developers.cliento.com/docs/widget/booking-page.md): No website of your own? Cliento can host a ready-made booking page for your business. There is no code to add anywhere: you get an address to share, and your...
- [Booking widget](https://developers.cliento.com/docs/widget.md): The booking widget puts Cliento's online booking on your own website. Your visitors choose a service and a time, enter their details and confirm, without lea...
- [Parameters](https://developers.cliento.com/docs/widget/parameters.md): Parameters adjust the widget: which services and resources it shows, its language, its colors, and more. You set each one in the widget code with the cbk(key...
- [Validation](https://developers.cliento.com/docs/widget/validation.md): You can show your own warnings and errors on the widget's customer details step, on top of the built‑in validation. You do it with the onValidate event. You...
- [Tracking](https://developers.cliento.com/docs/widget/tracking.md): The booking widget can send purchases to Google Tag Manager, Meta pixel, TikTok pixel and the OpenAI (ChatGPT Ads) pixel by itself. It also sends page views...
- [Styling](https://developers.cliento.com/docs/widget/styling.md): The booking widget can easily be styled using CSS variables. Put the new variable values in your own CSS file, or in a style tag in the head section of your...
- [Widget builder](https://developers.cliento.com/docs/widget/builder/)
- [Widget API overview](https://developers.cliento.com/docs/widget-api.md): With the Widget API you build your own booking experience: a fully custom booking flow on your site, or a native app. It is for when the booking widget canno...
- [Booking flow](https://developers.cliento.com/docs/widget-api/booking-flow.md): This guide walks through a complete booking, from loading services to a confirmed booking. It is the same sequence the Cliento booking widget uses. All examp...
- [Settings and ref-data](https://developers.cliento.com/docs/widget-api/reference-data.md): Load settings and ref-data when your booking UI starts, and cache them for the session. They change rarely. Settings say how booking is configured for the ac...
- [Availability](https://developers.cliento.com/docs/widget-api/availability.md): Ask for the available slots when the customer has chosen a service, and again each time they move to another week. A slot is a time the customer can book. Th...
- [Creating a booking](https://developers.cliento.com/docs/widget-api/booking.md): These endpoints create a booking, in the order described in the booking flow. The reserve call returns a reservation id, the cbUuid. Pass it in every followi...
- [Retrieving and cancelling a booking](https://developers.cliento.com/docs/widget-api/manage-booking.md): With these endpoints your client can show a confirmed booking and cancel it. Cliento's own "manage booking" page uses the same endpoints. That is the page li...
- [Payments](https://developers.cliento.com/docs/widget-api/payments.md): Some accounts require online payment for some or all services. This guide walks through how payment fits into the booking flow and what your client does for...
- [Payment endpoints](https://developers.cliento.com/docs/widget-api/payment-endpoints.md): These endpoints are used when a booking requires online payment. This page is the reference for each of them. Payments describes how they fit together for ea...
- [Reviews](https://developers.cliento.com/docs/widget-api/reviews.md): Some accounts collect reviews from their customers. These endpoints return them, so you can show them beside your booking flow. They are not part of making a...