# Haircut appointment with Buildery Example

- Host: Buildery Example
- Duration: 60 min
- Location: Barbershop, High Street 123
- Host time zone: Europe/Berlin
- Confirmation: Bookings are confirmed instantly.
- Booking page: https://cal.com/bldry/haircut
- Event type id: 1777573

## Check availability

```http
GET https://api.cal.com/v2/slots?eventTypeId=1777573&start=YYYY-MM-DD&end=YYYY-MM-DD&timeZone=<IANA time zone>
cal-api-version: 2024-09-04
```

The response is `{"data":{"YYYY-MM-DD":[{"start":"<ISO 8601 with offset>"}]}}`; no API key is needed.

## Book

```http
POST https://api.cal.com/v2/bookings
cal-api-version: 2026-02-25
Content-Type: application/json

{
  "eventTypeId": 1777573,
  "start": "<UTC ISO 8601 start from the slots response>",
  "attendee": {
    "name": "…",
    "email": "…",
    "timeZone": "<IANA time zone>"
  }
}
```

- Required fields: `name` (Your name), `email` (Email address)
- Optional fields: none
- `name` and `email` go in `attendee` and `guests` is a list of emails; every other field goes in `bookingFieldsResponses` under its name.