> For the complete documentation index, see [llms.txt](https://docs.parkflow.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.parkflow.io/widget/bookings.md).

# Bookings

From priced offer to confirmed reservation — the purchase flow of the Widget API.

### The booking flow

The purchase is two calls: **price it, then book it.**

1. [**Offer**](/widget/bookings/offers.md) — send the parking, arrival and departure; ParkFlow returns the price for the stay (vehicles, services, taxes) computed from the operator's live rates. This is the figure you display.
2. [**Create the booking**](/widget/bookings/booking.md) — submit the same stay together with the customer, vehicle and consent data. ParkFlow confirms the reservation and returns its `uuid`, reference `code` and a **booking token** for follow-up calls.

Below is a diagram detailing how the endpoints combine into a customer journey:

<figure><img src="https://1795124052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FitLitoDCXAvGWx61bo7x%2Fuploads%2FAnHhutD1jnBv1ql20rR5%2Fimage.png?alt=media&amp;token=43e5f3c4-a6b6-40b7-91f9-0bbb00b51bed" alt="Booking flow — from offer to confirmed booking"><figcaption><p>The booking flow</p></figcaption></figure>

### The status flow

A booking moves through a defined lifecycle — see [Constants](/reference/constants.md#booking-statuses) for the full status model.

<figure><img src="https://1795124052-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FitLitoDCXAvGWx61bo7x%2Fuploads%2Fr5FKtZ3Efw85AcXQfkNh%2Fimage%20(1).png?alt=media&amp;token=1136cf48-4ca9-4cd7-acc6-9bd300e890b6" alt="Booking status lifecycle"><figcaption><p>The status lifecycle</p></figcaption></figure>

### After the purchase

* **Payment** — if the stay is paid online, initiate a payment and redirect the customer to the operator's payment gateway; see [Manage a booking](/widget/bookings/manage.md#payments).
* **Voucher & receipt** — ParkFlow issues customer-facing voucher and receipt documents on signed URLs, delivered with the booking confirmation.
* **Self-service** — the customer can [sign in with email + booking code](/widget/bookings/manage.md) to view, amend or cancel within the operator's policy.