# 1️⃣ Echange rapide (30 minutes) with Stéphane RIOT-MAHÉ

> 👋🏻 Echange rapide ou premier contact 😃 Pour faire connaissance et se rencontrer ⏰ Durée : 30 minutes

- Host: Stéphane RIOT-MAHÉ
- Duration: 30 min
- Location: Zoom Video, A préciser lors de la confirmation du RDV
- Host time zone: Europe/Paris
- Confirmation: The host confirms each booking; it stays pending until they accept it.
- Booking page: https://cal.com/stephane-riot/30min
- Event type id: 2190317

## Check availability

```http
GET https://api.cal.com/v2/slots?eventTypeId=2190317&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": 2190317,
  "start": "<UTC ISO 8601 start from the slots response>",
  "attendee": {
    "name": "…",
    "email": "…",
    "timeZone": "<IANA time zone>"
  },
  "guests": [
    "guest@example.com"
  ],
  "bookingFieldsResponses": {
    "title": "…",
    "telephone": "…",
    "notes": "…"
  }
}
```

- Required fields: `name` (Your name), `email` (Email address), `title` (What is this meeting about?)
- Optional fields: `telephone` (Votre téléphone (en cas de besoin)), `notes` (Additional notes), `guests` (Add guests)
- `name` and `email` go in `attendee` and `guests` is a list of emails; every other field goes in `bookingFieldsResponses` under its name.
- `location` is optional; without it the booking uses the event’s first location.
- A successful response is a pending booking request.
