# Birthdays/ Social gatherings with Locked X Links

> For birthday parties, girls' nights, and such.

- Host: Locked X Links
- Duration: 30, 45, 60, 90, 120 min
- Location: In Person (Attendee Address)
- Host time zone: America/Chicago
- Confirmation: The host confirms each booking; it stays pending until they accept it.
- Booking page: https://cal.com/lockedxlinks/birthdays-social-gatherings
- Event type id: 624051

## Check availability

```http
GET https://api.cal.com/v2/slots?eventTypeId=624051&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": 624051,
  "start": "<UTC ISO 8601 start from the slots response>",
  "lengthInMinutes": 30,
  "attendee": {
    "name": "…",
    "email": "…",
    "timeZone": "<IANA time zone>"
  },
  "location": {
    "type": "attendeeAddress",
    "address": "…"
  },
  "guests": [
    "guest@example.com"
  ],
  "bookingFieldsResponses": {
    "Phone-Number": "…",
    "title": "…",
    "EVENT-Package": "…",
    "Add-Ons": "…",
    "Special-Requests": "…",
    "notes": "…"
  }
}
```

- Required fields: `name` (Your name), `Phone-Number` (Phone Number), `email` (Email address), `title` (Event Coordinator Information), `EVENT-Package` (Event Package Selection), `Add-Ons` (Add Ons), `Special-Requests` (Any special requests?)
- Optional fields: `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 required: `location.address` is the attendee’s own.
- `lengthInMinutes` picks one of 30, 45, 60, 90, 120; pass the same value to the slots request as `duration`.
- A successful response is a pending booking request.
