> ## Documentation Index
> Fetch the complete documentation index at: https://crevio.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Bookings

> Offer bookable services, read open slots, take free and paid bookings, and reschedule or cancel them.

**A booking is a time slot a customer reserves on one of the business's bookable services.** The service is an *event type*; its open times come from an availability *schedule*; a paid service is charged through the price variants linked to the event type's experience.

## The pieces

| Resource | What it is | Endpoints |
| - | - | - |
| Schedule (`sched_…`) | Reusable weekly availability in one time zone, with per-date overrides (days off, custom hours) | `/schedules` |
| Event type | A bookable service: duration, buffers, notice, booking window, daily cap, capacity, location, and the schedule it uses | `/event_types` |
| Slot | An open start time, computed, never stored | `GET /event_types/{id}/slots` |
| Booking | One reservation, with its times, status and the attendee's answers | `/bookings` |

Event type fields worth knowing:

| Field | Notes |
| - | - |
| `duration_minutes`, `buffer_before_minutes`, `buffer_after_minutes` | The session length and the gaps kept free around it. |
| `min_notice_minutes` | Earliest a slot can be booked, from now. |
| `booking_window_days` | How far ahead slots are offered. |
| `max_per_day`, `capacity` | Bookings per day, attendees per slot. |
| `location_type` | `google_meet`, `zoom`, `custom_link`, `physical` or `phone`, with `location_details` (ignored for `google_meet`, which generates a Meet link). |
| `schedule_id` | The availability schedule. |

## Free and paid

An event type is free to book unless a paid price variant is linked to the `experience_id` it returns:

```bash theme={null}
POST /v1/price_variants/{price_variant_id}/experiences
{ "experience_id": "<the event type's experience_id>" }
```

`POST /bookings` on a free event type confirms at once. On a paid one it returns a `pending` booking with a `checkout_url`; the booking is confirmed when that checkout is paid. Pass `price_variant_id` to choose which price to charge; it defaults to the experience's first paid variant.

## Reading availability

`GET /event_types/{id}/slots?from=2026-11-10&to=2026-11-17&timezone=America/Chicago` returns open slots between two dates (defaults: today and 14 days out). It already accounts for the schedule, buffers, notice, existing bookings and, when connected, the business's Google Calendar busy times. `timezone` sets the `local_start_time` in the response; book with the slot's UTC `start_time`.

## Booking, rescheduling and cancelling

* **Book:** `POST /bookings` with `event_type_id`, the slot's `start_time`, the attendee, their `time_zone` (for confirmations and reminders), and `intake_answers` when the event type has an intake form.
* **Reschedule:** `POST /bookings/{id}/reschedule` with a new `start_time`. Crevio checks the time is still free and updates the calendar event. Read the slots first.
* **Cancel:** `POST /bookings/{id}/cancel` frees the slot, removes the calendar event and emails the attendee.

> [!WARNING]
>
> Cancelling a paid booking does **not** refund it. Refund its order separately with `POST /refunds`.

## Next steps

* [Products and pricing](https://crevio.co/docs/developer/guides/products-and-pricing.md): price variants and experiences.
* [Webhooks](https://crevio.co/docs/developer/guides/webhooks.md): `booking.cancelled` and the other booking events.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.