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

# Appointments

> Offer real availability during a call and book the consultation.

Lawtte reads live availability so the agent never offers a slot that is already
taken, then books it while the caller is still on the phone.

<Steps>
  <Step title="Check availability">
    ```bash theme={null}
    curl -X POST https://www.lawtte.ai/api/v2/your-firm/check-availability \
      -H "Authorization: Bearer $LAWTTE_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{ "eventTypeId": 123456 }'
    ```

    Returns open slots in a seven-day window, localized to the firm's time zone.
  </Step>

  <Step title="Book the slot">
    ```bash theme={null}
    curl -X POST https://www.lawtte.ai/api/v2/your-firm/book-appointment \
      -H "Authorization: Bearer $LAWTTE_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "eventTypeId": 123456,
        "startTime": "2026-04-01T10:00:00-07:00",
        "name": "Jane Doe",
        "email": "jane@example.com",
        "phone": "+12125550100",
        "notes": "Rear-ended on the 405, seeing a chiropractor"
      }'
    ```
  </Step>

  <Step title="Handle the booking webhook">
    Booking created, rescheduled, and cancelled events post to your firm's booking
    webhook, which schedules the caller's reminders.
  </Step>
</Steps>

<Note>
  Studio receptionists can book through Google Calendar, Outlook, or Calendly
  instead. Connect a calendar in **Dashboard → Settings → Calendar**; no API work
  is required.
</Note>

## Round-robin and free/busy

Where a firm has several attorneys taking consultations, Lawtte reads each
calendar's real free/busy data and distributes bookings round-robin, so two
callers cannot land on the same slot.


## Related topics

- [Books an appointment on Cal.com on behalf of a caller](/api-reference/appointments/books-an-appointment-on-calcom-on-behalf-of-a-caller.md)
- [Returns available appointment slots for the given firm within a 7-day window using the Cal.com API](/api-reference/appointments/returns-available-appointment-slots-for-the-given-firm-within-a-7-day-window-using-the-calcom-api.md)
- [Call webhooks](/guides/call-webhooks.md)
- [Webhook receiver for Cal.com booking events](/api-reference/appointments/webhook-receiver-for-calcom-booking-events.md)
- [API overview](/api-reference/introduction.md)