# Cashiar Developers


- **Getting started**
- [Introduction](/docs): Sell from your own website or app, with Cashiar running the shop behind it.
- [Quickstart](/docs/quickstart): From a key to products on screen in five minutes.
- [Build with AI](/docs/build-with-ai): Make your own website with Lovable, v0 or any AI app builder, on your Cashiar shop.

- **Concepts**
- [Authentication](/docs/concepts/authentication): Publishable keys, the sites they work on, and what they can do.
- [Errors](/docs/concepts/errors): Status codes and the shape of every error.
- [Pagination](/docs/concepts/pagination): Cursor pages for lists.
- [Money and prices](/docs/concepts/money-and-prices): Minor units, currencies, price lists and pack sizes.
- [Rate limits](/docs/concepts/rate-limits): How many requests a key can make.
- [Idempotency](/docs/concepts/idempotency): Retry orders and bookings safely.
- [Versioning](/docs/concepts/versioning): What changes in v1, and what never does.

- **Guides**
- [Product list](/docs/guides/product-list): A shop page with collections, search and sorting.
- [Product page](/docs/guides/product-page): Versions, pack sizes, price types, extras and stock.
- [Cart and checkout](/docs/guides/cart-and-checkout): Turn a cart into an order, for pickup or delivery, paid now or later.
- [Order status](/docs/guides/order-status): Follow an order after it is placed.
- [Bookings](/docs/guides/bookings): Services, free times and booking, for salons, clinics and anything booked.

- **Frameworks**
- [React](/docs/frameworks/react): Hooks with TanStack Query, and a cart.
- [Next.js](/docs/frameworks/nextjs): Render the catalogue on the server and cache it.
- [JavaScript](/docs/frameworks/javascript): A tiny client for any website, with no framework.
- [Flutter](/docs/frameworks/flutter): A shop app in Dart.

- **Reference**
- API reference
  - [API reference](/docs/api-reference): Every Storefront API endpoint, with its fields, examples and a playground.
  - [Get the shop](/docs/api-reference/getShop): The shop: name, logo, currency and clock, the branch that fills online orders with its hours, whether it is open now, pickup and delivery with their fees, online payment, and the collections.
  - [List products](/docs/api-reference/listProducts): Products on sale online, a page at a time: search by name, filter by collection, sort by name or newest. Pass nextCursor back as cursor for the next page.
  - [Get a product](/docs/api-reference/getProduct): One product with its versions, selling units, prices, extras and stock.
  - [Place an order](/docs/api-reference/createOrder): Places an order as the online store’s checkout does: for pickup or delivery, paid now by link (payUrl) when the shop takes online payment, else at pickup or on delivery.
  - [Get an order](/docs/api-reference/getOrder): Where an order placed online is: waiting for the shop, open, completed or cancelled, what is paid, and its delivery.
  - [List services](/docs/api-reference/listServices): The services customers can book, with their prices, how long they take and the branches that offer them, and the days bookings are open.
  - [Get free times](/docs/api-reference/getFreeTimes): The start times free for a service on a day, at a branch that offers it.
  - [Book services](/docs/api-reference/createBooking): Books one or more services at a free time, confirmed straight away unless the shop confirms bookings itself; payUrl when the services ask for payment when booking.
- [Changelog](/docs/changelog): Every change to the Storefront API.